Create a locale | Documentation

curl -X POST https://api.contentful.com/spaces/yadj1kx9rmg0/environments/staging/locales \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/vnd.contentful.management.v1+json" \
     -d '{
  "name": "English (United States)",
  "code": "en-US",
  "fallbackCode": "en-US",
  "optional": false
}'

{
  "name": "English (United States)",
  "code": "en-US",
  "fallbackCode": "en-US",
  "contentDeliveryApi": true,
  "contentManagementApi": true,
  "default": false,
  "optional": false,
  "sys": {
    "type": "Locale",
    "id": "34N35DoyUQAtaKwWTgZs34",
    "version": 1,
    "space": {
      "sys": {
        "type": "Link",
        "linkType": "Space",
        "id": "yadj1kx9rmg0"
      }
    },
    "environment": {
      "sys": {
        "type": "Link",
        "linkType": "Environment",
        "id": "staging"
      }
    },
    "createdAt": "2025-09-21T13:03:32.000Z",
    "createdBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "7BslKh9TdKGOK41VmLDjFZ"
      }
    },
    "updatedAt": "2025-09-21T13:03:32.000Z",
    "updatedBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "4FLrUHftHW3v2BLi9fzfjU"
      }
    }
  }
}

Use this endpoint to create a new locale for the specified space. You cannot create two locales with the same locale code.

Authentication

AuthorizationBearer

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

Path parameters

space_idstringRequired

ID of the space in form of a string

environment_idstringRequired

ID of the environment in form of a string

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

Created - Resource created successfully