Create a resource type

PUT

https://api.contentful.com/organizations/:organization_id/app_definitions/:app_definition_id/resource_provider/resource_types/:resource_type_id

PUT

/organizations/:organization_id/app_definitions/:app_definition_id/resource_provider/resource_types/:resource_type_id

$ curl -X PUT https://api.contentful.com/organizations/0D9ZC8rLWiw6x5qizZGiRs/app_definitions/99SummRPRBowauM8T5Ljb34/resource_provider/resource_types/TMDB%3APerson \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/vnd.contentful.management.v1+json" \
>      -d '{
>   "name": "TMDB:Person",
>   "defaultFieldMapping": {
>     "externalUrl": "{ /externalUrl }",
>     "title": "{ /name }",
>     "subtitle": "Entity ID: { /urn }",
>     "image": {
>       "altText": "{ /name }",
>       "url": "{ /image/url }"
>     }
>   }
> }'

200Native external references_createAResourceType_example

1 {
2   "sys": {
3     "id": "TMDB:Person",
4     "type": "ResourceType",
5     "resourceProvider": {
6       "sys": {
7         "id": "TMDB",
8         "type": "Link",
9         "linkType": "ResourceProvider"
10       }
11     },
12     "createdAt": "2025-02-19T17:31:45.000Z",
13     "createdBy": {
14       "sys": {
15         "type": "Link",
16         "linkType": "User",
17         "id": "7BslKh9TdKGOK41VmLDjFZ"
18       }
19     },
20     "updatedAt": "2025-02-19T17:31:45.000Z",
21     "updatedBy": {
22       "sys": {
23         "type": "Link",
24         "linkType": "User",
25         "id": "4FLrUHftHW3v2BLi9fzfjU"
26       }
27     },
28     "appDefinition": {
29       "sys": {
30         "id": "99SummRPRBowauM8T5Ljb34",
31         "type": "Link",
32         "linkType": "AppDefinition"
33       }
34     }
35   },
36   "name": "TMDB:Person",
37   "defaultFieldMapping": {
38     "externalUrl": "{ /externalUrl }",
39     "title": "{ /name }",
40     "subtitle": "Entity ID: { /urn }",
41     "image": {
42       "altText": "{ /name }",
43       "url": "{ /image/url }"
44     }
45   }
46 }

Creates or updates a resource type for an app’s resource provider. Requires the app to have an associated resource provider — PUT fails without one.

Authentication

AuthorizationBearer

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

Path parameters

organization_idstringRequired

The ID of the organization

app_definition_idstringRequired

The ID of the app definition

resource_type_idstringRequired

The ID of the resource type

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful