Contentful Connector Setup Guide

How to Connect Contentful with SearchAtlas

Step 1: Generate a Content Management API (CMA) Token

1. Log in to Contentful

   • Visit https://app.contentful.com
   • Sign in with your Contentful account

2. Create a CMA Token

   • Go to Settings → CMA tokens
   • Click Create personal access token
   • Enter a descriptive name (e.g., SearchAtlas Integration)
   • Set expiration to No Expiration
   • Click Generate

3. Copy Your CMA Token

   • Copy the generated token (you will not be able to see it again)
   • Store it securely and keep it confidential

Step 2: Authorize Your CMA Token for the Organization

⚠️ Easy to miss — required before the token will work.

Some Contentful organizations require every Personal Access Token to be explicitly authorized before it can access any space. If you skip this, the connector will reject the token with: "The access token you sent does not have access to the requested resource" — even though the token is valid and your user has Owner or Admin permissions.

1. Open the CMA tokens page

   • Inside your space, go to Settings → CMA tokens
   • URL: app.contentful.com/spaces/<SPACE_ID>/api/cma_tokens

2. Find your newly created token in the list

   • Look for the token name you entered in Step 1
   • The "Token status" column will show Active, but the token is not yet authorized

3. Click "Authorize" on that row

   • Confirm the prompt to grant the token access to this organization
   • If Authorize is greyed out or missing, an Organization Owner (not just an Admin) must do this for you

4. Verify the token is now authorized

   • The row's "Authorize" link will disappear or be replaced with a confirmation indicator

Step 3: Get Your Space ID

1. Go to General Settings
   • In Contentful, navigate to Settings → General Settings
   • Locate the Space ID in the settings
   • Copy this value for later use

Step 4: Get Your Environment ID

1. Go to Environments
   • In Contentful, navigate to Settings → Environments
   • The default is usually master
   • Copy the environment ID you want to connect

Step 5: Connect to SearchAtlas

1. Enter the Following Details in SearchAtlas

   • CMA Token
   • Space ID
   • Environment ID

2. Test the Connection

   • Click Connect
   • SearchAtlas will verify your credentials
   • On success, you will see: "Contentful connected successfully"

Required Information

• CMA Token: From Contentful API token manager (must be authorized — see Step 2)
• Space ID: Unique identifier of your Contentful space
• Environment ID: The environment for publishing posts (e.g., master)

Important Requirements

• Token Authorization: The CMA token must be authorized for the organization (Step 2). Without this the connector will fail even with a valid token.
• Content Model Setup: Your Contentful space must have a blog content model configured
• Permissions: The CMA token must have full management access
• Environment Access: Ensure the selected environment is active and available

Troubleshooting

• Connection Failed: Verify your CMA token, Space ID, and Environment ID are correct
• "Token does not have access to the requested resource": The token was created but not yet authorized. Go to Settings → CMA tokens, find your token, and click Authorize. An Organization Owner may need to do this if you only have the Admin role.
• Invalid Token: Regenerate the CMA token, click Authorize on it, and update it in SearchAtlas
• Blog Not Available: Ensure your Contentful space has a blog content model configured
• Permission Denied: Confirm the CMA token has full permissions and has been authorized for the organization