# Contentful Graphql AI integration on Definable

> The Contentful GraphQL Content API allows developers to query and deliver content using GraphQL, providing a flexible and efficient way to access content stored in Contentful.

## What this connects

The Contentful GraphQL Content API allows developers to query and deliver content using GraphQL, providing a flexible and efficient way to access content stored in Contentful.

Vendor: https://www.contentful.com/developers/docs/references/graphql/

## Tools available

**2** tools available. First 2:

- `CONTENTFUL_GRAPHQL_GET_CMA_TOKEN` — Get CMA Token — Tool to retrieve a Contentful Management API (CMA) access token. Use when making CMA calls to ensure valid authorization.
- `CONTENTFUL_GRAPHQL_GRAPH_QL_CONTENT_API_PERSISTED_QUERY` — GraphQL Content API Persisted Query — Execute a GraphQL query using Automatic Persisted Queries (APQ). APQ reduces bandwidth by sending only a SHA256 hash instead of the full query text after initial registration. Workflow: 1. First request: Include both sha256_hash and query text to register the query 2. Subsequent requests: Send only sha256_hash and variables - the server uses the cached query Common errors: - PersistedQueryNotFound: Query not cached; include the full query text - PersistedQueryMismatch: Hash doesn't match query text; recompute the hash - UNKNOWN_SPACE: Invalid space_id or access_token for the space

## Auth

Auth schemes: `API_KEY`.

## How agents use Contentful Graphql

Inside a Definable workflow, Contentful Graphql is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Contentful Graphql** — the Researcher (GPT-5.5) pulls context from Contentful Graphql (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Contentful Graphql** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Contentful Graphql (create record, post message, draft email).
- **Designer / Engineer → Distributor → Contentful Graphql** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Contentful Graphql (attach file, open PR comment, post status).

The Verifier checks every Contentful Graphql call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- developer tools — https://definable.ai/apps/category/developer-tools/
- website builders — https://definable.ai/apps/category/website-builders/

## Related

- HTML page: https://definable.ai/apps/contentful_graphql/
- Same category (developer tools): https://definable.ai/apps/category/developer-tools/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt