> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Contentful

> Follow these steps to connect Contentful via the StackOne Hub successfully.

<Warning>
  Ensure you have Admin privileges within your Contentful organization.
</Warning>

If you've been directed to StackOne to integrate with Contentful, the following steps will help you understand the process and any necessary actions to configure successful integration.

Each connection will be associated with a single Space within a Contentful organization.

## Get your Contentful Organization ID

<Steps>
  <Step title="Log in to Contentful">
    Log in to your [Contentful app](https://app.contentful.com)
  </Step>

  <Step title="Expand Side Panel">
    Click the top left navigation icon to expand the side panel.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Side Panel" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/contentful/image1.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=d70f2663d19cb98b8603de9b874a4b25" width="572" height="505" data-path="images/contentful/image1.png" />
    </Frame>
  </Step>

  <Step title="Organization Settings">
    At the bottom of the side panel, click Organization settings & subscriptions.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Organization Settings" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/contentful/image2.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=8cc53d83a839383284eb14569a9103ca" width="754" height="904" data-path="images/contentful/image2.png" />
    </Frame>
  </Step>

  <Step title="Copy Organization ID">
    The Organization ID is available in the URL: `https://app.contentful.com/account/organizations/{Organization ID}/etc_path`. Copy and store the Organization ID safely. The ID is also viewable by clicking Organization information in the top navigation.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Organization Information" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/contentful/image3.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=1acb14c072bff56355a7c0028ca8d838" width="1025" height="696" data-path="images/contentful/image3.png" />
    </Frame>
  </Step>
</Steps>

## Get your Contentful Space ID

<Steps>
  <Step title="Navigate to Spaces">
    Within Organization Settings, click Spaces in the top navigation.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Spaces" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/contentful/image4.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=7852da9fc9931099aaede25c6ef67d08" width="984" height="502" data-path="images/contentful/image4.png" />
    </Frame>
  </Step>

  <Step title="Select Space">
    Scroll down to view the list of Spaces in your Organization, and click the Space that will be associated with this connection.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Select Space" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/contentful/image5.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=dd843e18ac0dd627e73ba7d589af1a7c" width="1678" height="888" data-path="images/contentful/image5.png" />
    </Frame>
  </Step>

  <Step title="Copy Space ID">
    The Space ID is visible in the URL: `https://app.contentful.com/spaces/{Space ID}/home`. Copy and store the Space ID safely.
  </Step>
</Steps>

## Get your Contentful CMA API Token

This CMA Token is required to access Contentful's Content Management API.

<Steps>
  <Step title="Account Settings">
    Within your [Contentful app](https://app.contentful.com), click your profile icon in the top right, then click Account Settings.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Account Settings" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/contentful/image6.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=545e01cb65358069b14e8163d743698f" width="1679" height="776" data-path="images/contentful/image6.png" />
    </Frame>
  </Step>

  <Step title="CMA Tokens">
    Click CMA Tokens in the top navigation.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="CMA Tokens" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/contentful/image7.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=dd7cb3656ad4225218f6347efe59ed48" width="894" height="659" data-path="images/contentful/image7.png" />
    </Frame>
  </Step>

  <Step title="Create Token">
    Within CMA Tokens, click the Create personal access token button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Create Token" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/contentful/image8.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=d8e242217fa934e294d1acfd0bd1214a" width="1678" height="544" data-path="images/contentful/image8.png" />
    </Frame>
  </Step>

  <Step title="Generate Token">
    Within the window that appears, enter a Name for your new token and set the desired Expiration date. Click Generate.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Generate Token" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/contentful/image9.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=2346e7135fc3d4f60c1ae9e4eaf4ef54" width="654" height="437" data-path="images/contentful/image9.png" />
    </Frame>
  </Step>

  <Step title="Copy API Token">
    Copy the newly generated API Token and store it safely. It will only be displayed once.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Copy API Token" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/contentful/image10.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=38d5427cbe66836092987ee6f0655a98" width="654" height="421" data-path="images/contentful/image10.png" />
    </Frame>
  </Step>
</Steps>

## Connecting to StackOne

<Steps>
  <Step title="Enter Credentials">
    Upon reaching the Link Account page, enter the credentials from the previous steps:

    <ul>
      <li>API Token</li>
      <li>Organization ID</li>
      <li>Space ID</li>
    </ul>

    Proceed by clicking the Connect button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Link Account" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/contentful/image11.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=2dae64175ba338e64b453eb1323ba26e" width="486" height="607" data-path="images/contentful/image11.png" />
    </Frame>
  </Step>
</Steps>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!

## Available data

This integration has the following [IAM Resources](https://docs.stackone.com/reference/iam_list_users) available from the provider:

<ul>
  <li>Users</li>
  <li>Roles</li>
  <li>Groups</li>
</ul>

## Useful Links

<Card title="API Reference" icon="link" href="https://www.contentful.com/developers/docs/references/content-management-api/">
  [https://www.contentful.com/developers/docs/references/content-management-api/](https://www.contentful.com/developers/docs/references/content-management-api/)
</Card>