> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parable.work/llms.txt
> Use this file to discover all available pages before exploring further.

# API Token

> Connect Parable to Contentful using a personal access token

export const platform_1 = "Contentful"

export const limit_0 = "CMA: 7 requests/second; CDA: 55 requests/second (default, varies by plan)"

export const platform_0 = "Contentful"

export const role_0 = undefined

export const tokenName_0 = "personal access token"

<Tabs>
  <Tab title="Setup">
    <Card title="What You'll Need" icon="key">
      | Credential   | What it is                                |
      | ------------ | ----------------------------------------- |
      | **Token**    | CMA personal access token from Contentful |
      | **Space ID** | Your Contentful space identifier          |
    </Card>

    ## Overview

    Connect Parable to Contentful Content Management API for content data access.

    <CardGroup cols={2}>
      <Card title="Content" icon="file-lines">
        Entries, content types, assets
      </Card>

      <Card title="Space Management" icon="folder">
        Spaces, environments, users
      </Card>
    </CardGroup>

    ## Prerequisites

    <Info>
      **Setup access in {platform_0}.** These steps require **{role_0}**, or a colleague with equivalent permissions who can create credentials for you.

      If that is not you, ask your {platform_0} administrator.
    </Info>

    * **Admin** role in the Contentful space
    * Permission to create API tokens

    ## Setup Guide

    <Steps>
      <Step title="Access Settings">
        1. Log in to Contentful
        2. Go to **Settings** → **API keys**
        3. Navigate to **Content Management tokens** tab
      </Step>

      <Step title="Generate Personal Access Token">
        1. Click **Generate personal token**
        2. Name: `Parable Integration`
        3. Click **Generate**

        <Warning>
          **Copy your {tokenName_0} now!**

          This is the only time it will be displayed. Store it in a secure password manager before closing this page.
        </Warning>
      </Step>

      <Step title="Note Your Space ID">
        Find your Space ID in:

        * **Settings** → **General settings** → **Space ID**
        * Or in the URL: `app.contentful.com/spaces/{SPACE_ID}/...`
      </Step>

      <Step title="Enter values in the form">
        1. **Token** and **Space ID**: Paste your Content Management API token and space identifier.
        2. Click **Save & test connection**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Reference">
    ## Verify Your Setup

    <CodeGroup>
      ```bash Test Authentication theme={null}
      curl -H "Authorization: Bearer YOUR_TOKEN" \
        "https://api.contentful.com/spaces"
      ```

      ```bash List Entries theme={null}
      curl -H "Authorization: Bearer YOUR_TOKEN" \
        "https://api.contentful.com/spaces/YOUR_SPACE_ID/environments/master/entries?limit=5"
      ```
    </CodeGroup>

    <Check>
      **Success!** If you received a `200 OK` response with valid data, your credentials are configured correctly. You can now proceed to configure this connector in Parable.
    </Check>

    <Tip>
      **Rate Limits:** {platform_1} enforces rate limits of **{limit_0}**.

      Parable handles rate limiting automatically with exponential backoff, but initial syncs of large datasets may take longer due to these limits.
    </Tip>

    ## Troubleshooting

    | Error                | Meaning                 | Solution                |
    | -------------------- | ----------------------- | ----------------------- |
    | `AccessTokenInvalid` | Invalid token           | Verify token is correct |
    | `NotFound`           | Wrong space/environment | Check Space ID          |
    | `RateLimitExceeded`  | Too many requests       | Implement backoff       |

    ## Additional Resources

    <CardGroup cols={2}>
      <Card title="Contentful API" icon="book" href="https://www.contentful.com/developers/docs/references/content-management-api/">
        Official API documentation
      </Card>
    </CardGroup>
  </Tab>
</Tabs>