Create a space | Documentation

curl -X POST https://api.contentful.com/spaces \
     -H "X-Contentful-Organization: 1PLOOEmTI2S1NYald2TemO" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/vnd.contentful.management.v1+json" \
     -d '{
  "name": "Example Space",
  "defaultLocale": "en",
  "productId": "<product_id>"
}'

{
  "sys": {
    "type": "Space",
    "id": "yadj1kx9rmg0",
    "version": 3,
    "organization": {
      "sys": {
        "id": "0D9ZC8rLWiw6x5qizZGiRs",
        "type": "Link",
        "linkType": "Organization"
      }
    },
    "createdAt": "2025-06-04T11:58:18.000Z",
    "createdBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "7BslKh9TdKGOK41VmLDjFZ"
      }
    },
    "updatedAt": "2025-06-24T08:06:46.000Z",
    "updatedBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "4FLrUHftHW3v2BLi9fzfjU"
      }
    }
  },
  "name": "Contentful Example API"
}

Create a new space, specifying attributes in the request body. You can optionally pass a productId to assign a specific product (from your organization’s available licenses) to the new space.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

X-Contentful-OrganizationstringOptional

Organization ID to create the space under

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

Created - Resource created successfully