Set up a connection to Contentful

Naga Sri Hari Gonaboyina

Updated November 22, 2024 11:04

Contentful is a cloud-based content management system (CMS) designed to help organizations create, manage, and deliver digital content across various platforms and channels.

Set up a connection

After you start the connection, configure it in the Create connection panel and complete all of the required * authentication settings:

Setting	Instructions
Name your connection *	Enter a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.
API type *	Choose your Contentful API type: Content delivery: Get displayed published content details Content image: Get transformed image details Content management: Get the created or updated content details Content preview: Get unpublished content details Content SCIM: Get the teams and organization membership details Content user management: Get users and organization membership details
Region *	Select your Contentful account region (either EU or Non-EU).
Space ID * (for content delivery API type)	Enter your Contentful space ID. How to retrieve the space ID
CDA access token * (for content delivery API type)	Enter your Contentful CDA access token. Multiple layers of protection, including AES 256 encryption, are in place to keep your CDA token safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text. How to retrieve the CDA access token
CPA access token * (for content preview and SCIM API types)	Enter your Contentful CPA access token. Multiple layers of protection, including AES 256 encryption, are in place to keep your CPA token safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text. How to retrieve the CPA access token
CMA access token * (for content user management API type)	Enter your Contentful CMA access token. Multiple layers of protection, including AES 256 encryption, are in place to keep your CMA token safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text. How to retrieve the CMA access token
Organization ID * (for content SCIM and user management API types)	Enter your Contentful organization ID. How to retrieve the organization ID

Tip

This connector documentation describes only the settings shown for the Simple view. For the corresponding HTTP settings, see Token auth universal connector documentation.

How to retrieve the space ID, CDA access token, and CPA access token

Sign in to your Contentful account.
Navigate to Settings > API keys.
Click + Add API key.
Enter a Name.
Click Add API key.
Copy the Space ID.
Copy the CDA access token.
Copy the CPA access token.

How to retrieve the CMA access token

Sign in to your Contentful account.
Navigate to Settings > CMA tokens.
Click + Create personal access token.
Enter a Token name and select Expiration date.
Click Generate.
Copy the Personal access token.

How to retrieve the organization ID

Sign in to your Contentful account.
Click the Contentful icon in the top left corner.
Click Organization.
Click + Create organization.
Enter a Name.
Click Create organization.
Copy the Organization ID.