Create an environment template

POST

https://api.contentful.com/organizations/:organization_id/environment_templates

POST

/organizations/:organization_id/environment_templates

$ curl -X POST https://api.contentful.com/organizations/organization_id/environment_templates \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/vnd.contentful.management.v1+json" \
>      -d '{
>   "name": "my-template",
>   "description": "My Template",
>   "versionName": "First Version",
>   "versionDescription": "First Version",
>   "entities": {
>     "contentTypeTemplates": [
>       {
>         "name": "Blogpost",
>         "description": "A blogpost content type",
>         "displayField": "title",
>         "fields": [
>           {
>             "id": "title",
>             "name": "title",
>             "type": "Text"
>           }
>         ],
>         "id": "blogpost"
>       }
>     ],
>     "editorInterfaceTemplates": [
>       {
>         "contentTypeTemplate": {
>           "sys": {
>             "id": "blogpost",
>             "linkType": "ContentTypeTemplate",
>             "type": "Link"
>           }
>         },
>         "controls": [
>           {
>             "fieldId": "title",
>             "widgetId": "urlEditor",
>             "widgetNamespace": "builtin",
>             "settings": {
>               "helpText": "help text"
>             }
>           }
>         ]
>       }
>     ],
>     "forTemplatedSpaces": false
>   }
> }'

201Content model templates_createAnEnvironmentTemplate_example

1 {
2   "sys": {
3     "id": "2nZrYQn7N7xijNAOhkKUrH",
4     "type": "EnvironmentTemplate",
5     "createdAt": "2025-06-06T05:43:39.000Z",
6     "updatedAt": "2025-06-06T05:43:39.000Z",
7     "version": "1",
8     "createdBy": {
9       "sys": {
10         "type": "Link",
11         "linkType": "User",
12         "id": "75cxRYbSLlWMlCrN1tZGdP"
13       }
14     },
15     "updatedBy": {
16       "sys": {
17         "type": "Link",
18         "linkType": "User",
19         "id": "75cxRYbSLlWMlCrN1tZGdP"
20       }
21     },
22     "organization": {
23       "sys": {
24         "type": "Link",
25         "linkType": "Organization",
26         "id": "75gbeC7tWNTERE55diMpCN"
27       }
28     }
29   },
30   "name": "my-template",
31   "description": "My Template",
32   "versionName": "First Version",
33   "versionDescription": "First Version",
34   "entities": {
35     "contentTypeTemplates": [
36       {
37         "name": "Blogpost",
38         "description": "A blogpost content type",
39         "displayField": "title",
40         "fields": [
41           {
42             "id": "title",
43             "name": "title",
44             "type": "Text"
45           }
46         ],
47         "id": "blogpost"
48       }
49     ],
50     "editorInterfaceTemplates": [
51       {
52         "contentTypeTemplate": {
53           "sys": {
54             "id": "blogpost",
55             "linkType": "ContentTypeTemplate",
56             "type": "Link"
57           }
58         },
59         "controls": [
60           {
61             "fieldId": "title",
62             "widgetId": "urlEditor",
63             "widgetNamespace": "builtin",
64             "settings": {
65               "helpText": "help text"
66             }
67           }
68         ]
69       }
70     ]
71   },
72   "forTemplatedSpaces": "false"
73 }

This action creates an environment template in the organization repository. It implicitly creates a new version for this template.

Authentication

AuthorizationBearer

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

Path parameters

organization_idstringRequired

organization_id identifier

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

Created - Resource created successfully