Create a content type with a specified ID

PUT

https://api.contentful.com/spaces/:space_id/environments/:environment_id/content_types/:content_type_id

PUT

/spaces/:space_id/environments/:environment_id/content_types/:content_type_id

$ curl -X PUT https://api.contentful.com/spaces/yadj1kx9rmg0/environments/staging/content_types/2PqfXUJwE8qSYKuM0U6w8M \
>      -H "X-Contentful-Version: 14" \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/vnd.contentful.management.v1+json" \
>      -d '{
>   "name": "Blog Post",
>   "fields": [
>     {
>       "id": "title",
>       "name": "Title",
>       "required": true,
>       "localized": true,
>       "type": "Text"
>     },
>     {
>       "id": "body",
>       "name": "Body",
>       "required": true,
>       "localized": true,
>       "type": "Text"
>     }
>   ]
> }'

201Content types_createAContentTypeWithASpecifiedId_example

1 {
2   "sys": {
3     "type": "ContentType",
4     "id": "3ORKIAOaJqQWWg86MWkyOs",
5     "version": 1,
6     "space": {
7       "sys": {
8         "type": "Link",
9         "linkType": "Space",
10         "id": "yadj1kx9rmg0"
11       }
12     },
13     "environment": {
14       "sys": {
15         "type": "Link",
16         "linkType": "Environment",
17         "id": "staging"
18       }
19     },
20     "createdAt": "2026-01-13T11:31:07.000Z",
21     "createdBy": {
22       "sys": {
23         "type": "Link",
24         "linkType": "User",
25         "id": "7BslKh9TdKGOK41VmLDjFZ"
26       }
27     },
28     "updatedAt": "2026-01-13T11:31:07.000Z",
29     "updatedBy": {
30       "sys": {
31         "type": "Link",
32         "linkType": "User",
33         "id": "4FLrUHftHW3v2BLi9fzfjU"
34       }
35     }
36   }
37 }

Creates a new content type with the specified ID or updates an existing one. When updating, include the current version in X-Contentful-Version.

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

content_type_idstringRequired

ID of the Content Type in form of a string

Headers

X-Contentful-VersionstringOptional

Version of the content type to update

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

Created - Resource created successfully