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

# Connect Contentful with App Identity – StackOne Hub

> Link a Contentful account in the StackOne Hub using App Identity. End-user guide to authorize the integration and start using Contentful actions.

> [!WARNING]
>
> Creating and installing a custom app requires the organization Owner, Admin or Developer role.

## Create and install a custom app

A custom app gives StackOne its own identity in one space environment, separate from any user account.

**1. Create the app**

Sign in to your [Contentful account](https://app.contentful.com/deeplink?link=app-definition-list), which opens the organization's **Apps** page.

<ul>
  <li>Click **Create app**.</li>
</ul>

![The organization Apps page with the Apps tab and the Create app button highlighted](https://mintcdn.com/stackone-60/CU1A8lPDgV2amWnH/connectors/contentful/images/app-identity-config-create-app.png?fit=max\&auto=format\&n=CU1A8lPDgV2amWnH\&q=85\&s=f7ff15a072013b78fd0c7ca9aed2fb13)

**2. Name the app**

On the **App details** page, the **General** tab holds the app name.

<ul>
  <li>**Name**: `StackOne Integration`</li>
  <li>Click **Save**, then click **Save** again in the **Save app** confirmation.</li>
  <li>The ID shown under the app name is the **App Definition ID**. Copy the **App Definition ID** across.</li>
</ul>

![The App details page with the Name field and the Save button highlighted](https://mintcdn.com/stackone-60/CU1A8lPDgV2amWnH/connectors/contentful/images/app-identity-config-name-app.png?fit=max\&auto=format\&n=CU1A8lPDgV2amWnH\&q=85\&s=f405273fa3fc4803a701a812d8e6f221)

**3. Generate a key pair**

Open the **Security** tab of the app.

<ul>
  <li>Under **Key pairs**, click **Generate key pair**.</li>
  <li>Your browser downloads the private key as a `.pem` file. Contentful only stores the public key, so the private key cannot be downloaded again.</li>
  <li>Open the file. Its entire contents, including the `BEGIN` and `END` lines, are the **App Private Key (PEM)**. Copy the **App Private Key (PEM)** across.</li>
</ul>

![The Security tab with the Generate key pair button highlighted](https://mintcdn.com/stackone-60/CU1A8lPDgV2amWnH/connectors/contentful/images/app-identity-config-generate-key-pair.png?fit=max\&auto=format\&n=CU1A8lPDgV2amWnH\&q=85\&s=5032c99402fadfb0107389bfbe364859)

**4. Install the app in a space environment**

On the **App details** page, open the **Actions** menu and click **Install to space**.

<ul>
  <li>**Select a space**: the space StackOne will work in</li>
  <li>**Select an environment**: the environment StackOne will work in, such as `master`</li>
  <li>Click **Continue**.</li>
  <li>In **Manage app access**, click **Authorize access**.</li>
  <li>The app can only read and change content in the space environment you select here.</li>
</ul>

![The Install StackOne Integration to a space dialog with the space and environment selectors and the Continue button highlighted](https://mintcdn.com/stackone-60/CU1A8lPDgV2amWnH/connectors/contentful/images/app-identity-config-install-app.png?fit=max\&auto=format\&n=CU1A8lPDgV2amWnH\&q=85\&s=8c8b45430d4ca3b058ee74bcaa44a4cb)

## Find your space and environment IDs

The **Space ID** and **Environment ID** identify the space environment where you installed the app.

**1. Copy the Space ID**

In the space where you installed the app, click the settings icon and select **General settings**.

<ul>
  <li>Under **Space details**, copy the **Space ID** across.</li>
  <li>Example: `abc123xyz789`</li>
</ul>

![The General settings page with the copy button next to the Space ID highlighted](https://mintcdn.com/stackone-60/CU1A8lPDgV2amWnH/connectors/contentful/images/app-identity-config-space-id.png?fit=max\&auto=format\&n=CU1A8lPDgV2amWnH\&q=85\&s=3d3973b532086b4c2eaf53355210d377)

**2. Copy the Environment ID**

In the same space, click the settings icon and select **Environments**.

<ul>
  <li>Copy the **Environment ID** of the environment you installed the app in across.</li>
  <li>Example: `master`</li>
</ul>

![The Environments page with the master environment ID highlighted](https://mintcdn.com/stackone-60/CU1A8lPDgV2amWnH/connectors/contentful/images/app-identity-config-environment-id.png?fit=max\&auto=format\&n=CU1A8lPDgV2amWnH\&q=85\&s=a58636dd952a424b577ee975d94d2625)

## Link the Account

**1. Connect**

<ul>
  <li>Click **Connect**.</li>
  <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
  <li>Once authorization is successful, you will see a confirmation popup.</li>
</ul>

**2. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Next Steps

> [card] [Webhooks setup](https://docs.stackone.com/connectors/contentful/guides/webhook-setup.md)
>
> Configure receiving Events for Contentful into StackOne.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.