---
search:
  tags:
    - Spaces
    - POST
seo:
  description: >-
    Creates a space — one per customer, typically. Domains, mailboxes, rules and
    suppressions are… Reference for the POST /spaces endpoint in the AI Inbx API
    API.
sidebar:
  label: Create a space
  badge: POST
title: Create a space
type: openapi-operation
---
Creates a space — one per customer, typically. Domains, mailboxes, rules and suppressions are put in a space with `space_id` when they are created, and every email and thread inherits the space of the domain or mailbox it went through. Anything created without a `space_id` belongs to the workspace itself and `space_id` reads as null. API keys and webhook endpoints belong to the workspace. `external_id` is your own id for the customer: unique per workspace, so a second space for the same customer is `409 external_id_taken`, and the space can be found by it with `GET /spaces?external_id=`.

<Operation source="api-endpoints" id="create-space" />