Skip to main content

Contentful

BotDojo can index published entries from a Contentful space with the read-only Content Delivery API.

Requirements​

  • Your Contentful Space ID
  • The Environment ID to sync, such as master
  • A Content Delivery API access token that can access that environment
  • The space's data residency: US or EU

To create a token, open the space in Contentful, go to Settings → API keys, create an API key, and make sure it can access the environment you intend to sync. See Contentful's authentication guide for details.

Connect Contentful​

  1. In BotDojo, go to Integrations → Data.
  2. Select Contentful.
  3. Enter the Space ID, Environment ID, Content Delivery API access token, and data residency.
  4. Select Test Connection, then Connect after the test succeeds.

Create a data loader​

  1. Go to Data and select Import Data.
  2. Choose or create the destination folder, then select Contentful as the source.
  3. Choose the connected Contentful integration.
  4. Optionally select one or more content types. Leave the selection empty to sync all content types.
  5. Configure the update schedule and save the loader.

Each published entry is indexed as JSON and preserves its localized field values and Contentful metadata. Later successful runs reconcile the destination with Contentful, so entries that are unpublished or deleted are removed when previous records are not retained.

note

The loader uses the Content Delivery API. It does not index drafts, binary asset files, or content from linked spaces.