Create an entry with a specified ID

PUT

https://api.contentful.com/spaces/:space_id/environments/:environment_id/entries/:entry_id

PUT

/spaces/:space_id/environments/:environment_id/entries/:entry_id

$ curl -X PUT https://api.contentful.com/spaces/yadj1kx9rmg0/environments/staging/entries/5KsDBWseXY6QegucYAoacS \
>      -H "X-Contentful-Content-Type: 2PqfXUJwE8qSYKuM0U6w8M" \
>      -H "X-Contentful-Version: 1" \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/vnd.contentful.management.v1+json" \
>      -d '{
>   "fields": {
>     "title": {
>       "en-US": "Hello, World!"
>     },
>     "body": {
>       "en-US": "Bacon is healthy!"
>     }
>   },
>   "metadata": {
>     "tags": [
>       {
>         "sys": {
>           "type": "Link",
>           "linkType": "Tag",
>           "id": "nyCampaign"
>         }
>       }
>     ]
>   }
> }'

200Entries_createAnEntryWithASpecifiedId_example

1 {
2   "fields": {
3     "title": {
4       "en-US": "Hello, World!"
5     },
6     "body": {
7       "en-US": "Bacon is healthy!"
8     }
9   },
10   "metadata": {
11     "tags": [
12       {
13         "sys": {
14           "type": "Link",
15           "linkType": "Tag",
16           "id": "nyCampaign"
17         }
18       }
19     ]
20   },
21   "sys": {
22     "id": "5KsDBWseXY6QegucYAoacS",
23     "type": "Entry",
24     "contentType": {
25       "sys": {
26         "type": "Link",
27         "linkType": "ContentType",
28         "id": "hfM9RCJIk0wIm06WkEOQY"
29       }
30     },
31     "version": 1,
32     "space": {
33       "sys": {
34         "type": "Link",
35         "linkType": "Space",
36         "id": "yadj1kx9rmg0"
37       }
38     },
39     "environment": {
40       "sys": {
41         "type": "Link",
42         "linkType": "Environment",
43         "id": "staging"
44       }
45     },
46     "createdAt": "2025-06-16T09:39:48.000Z",
47     "createdBy": {
48       "sys": {
49         "type": "Link",
50         "linkType": "User",
51         "id": "7BslKh9TdKGOK41VmLDjFZ"
52       }
53     },
54     "updatedAt": "2025-06-16T09:39:48.000Z",
55     "updatedBy": {
56       "sys": {
57         "type": "Link",
58         "linkType": "User",
59         "id": "4FLrUHftHW3v2BLi9fzfjU"
60       }
61     }
62   }
63 }

Creates a new entry with the specified ID or updates an existing one. Pass X-Contentful-Content-Type when creating; include X-Contentful-Version when updating.

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

entry_idstringRequired

ID of the entry in form of a string

Headers

X-Contentful-Content-TypestringOptional

The content type ID for the entry to create

X-Contentful-VersionstringOptional

The last version of the entry you are updating

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful