Create a scheduled action

POST

https://api.contentful.com/spaces/:space_id/scheduled_actions

POST

/spaces/:space_id/scheduled_actions

$ curl -X POST https://api.contentful.com/spaces/yadj1kx9rmg0/scheduled_actions \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/vnd.contentful.management.v1+json" \
>      -d '{
>   "entity": {
>     "sys": {
>       "type": "Link",
>       "linkType": "Entry",
>       "id": "5KsDBWseXY6QegucYAoacS"
>     }
>   },
>   "environment": {
>     "sys": {
>       "type": "Link",
>       "linkType": "Environment",
>       "id": "staging"
>     }
>   },
>   "scheduledFor": {
>     "datetime": "2022-01-01T12:00:00.000Z",
>     "timezone": "Europe/Berlin"
>   },
>   "action": "publish"
> }'

201Scheduled Actions_createAScheduledAction_example

1 {
2   "entity": {
3     "sys": {
4       "type": "Link",
5       "linkType": "Entry",
6       "id": "5KsDBWseXY6QegucYAoacS"
7     }
8   },
9   "environment": {
10     "sys": {
11       "type": "Link",
12       "linkType": "Environment",
13       "id": "staging"
14     }
15   },
16   "scheduledFor": {
17     "datetime": "2022-01-01T12:00:00.000Z",
18     "timezone": "Europe/Berlin"
19   },
20   "action": "publish",
21   "sys": {
22     "id": "3A13SXSDwO8c46NrjigFYT",
23     "type": "ScheduledAction",
24     "status": "scheduled",
25     "createdAt": "2025-09-03T17:33:40.000Z",
26     "createdBy": {
27       "sys": {
28         "type": "Link",
29         "linkType": "User",
30         "id": "7BslKh9TdKGOK41VmLDjFZ"
31       }
32     },
33     "space": {
34       "sys": {
35         "type": "Link",
36         "id": "yadj1kx9rmg0"
37       }
38     },
39     "updatedAt": "2025-09-03T17:33:40.000Z",
40     "updatedBy": {
41       "sys": {
42         "type": "Link",
43         "linkType": "User",
44         "id": "7BslKh9TdKGOK41VmLDjFZ"
45       }
46     },
47     "version": 1
48   }
49 }

Creates a scheduled action with an auto-generated ID. Limit is 200 pending scheduled actions per environment; scheduledFor.datetime must be a future ISO 8601 timestamp.

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

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

Created - Resource created successfully