## Contentful integration

Contentful is a headless content management system (CMS) that stores and delivers structured content through APIs. Integrating Contentful with Frontegg lets your application manage entries, content types, assets, and other resources on behalf of your users — all through Frontegg's integration layer. Contentful authenticates with OAuth 2.0 (Authorization Code flow), so you register an OAuth application in your Contentful account to obtain a Client ID and Client Secret.

Prerequisites
- A [Contentful](https://www.contentful.com/) account
- Access to your account's [OAuth applications](https://app.contentful.com/account/profile/developers/applications) settings


### Connect to Contentful

You register an OAuth 2.0 application in the Contentful web app. The application provides the **Client ID** and **Client Secret** and defines the **Redirect URI** that Contentful returns users to after they authorize access.

#### Step 1: Open OAuth applications

Sign in to Contentful and open **OAuth applications** (under your account's developer settings). Click **Create application**.

![Contentful OAuth Applications page with the Create application button](/assets/contentful-1.8f352a0fd44d950ce01744708ce661dddaaf3d8fa3327bc8f414d8d913d2616d.1ce25488.png)

#### Step 2: Fill in the application details

Complete the **New application** form:

- **Name** — A descriptive name, for example `Frontegg Integration`.
- **Description** — A short description of the application.
- **Redirect URI** — Your Frontegg Redirect URL: `https://YOUR_MCP_GATEWAY_URL/integration-callback`
- **Expiration date** — The lifetime of access tokens issued to the application. Choose a duration that suits your integration.
- **Manage** — Enable **Manage** to grant read and write access to content. Keep **Confidential** selected so the app authenticates with a Client ID and Client Secret.


Click **Create application**.

![Contentful New application form with the Redirect URI and Manage scope highlighted](/assets/contentful-2.817038750f0ed48b474e366b99b310da0672481e559fc40455e1102bd4f6d661.1ce25488.png)

#### Step 3: Copy the Client ID and Client Secret

Open the application. Contentful displays the **Client ID** and **Client Secret**. Copy both values.

Keep your Client Secret safe
The Client Secret grants access to your account through the API. Treat it like a password and never expose it in client-side code or commit it to version control.

![Contentful application details showing the Client ID and Client Secret](/assets/contentful-3.a0088a016402e98ec74617bd92c47c89c99382de67e09c0a82d8a39053721ce8.1ce25488.png)

### Configure the Frontegg portal

Once you have your **Client ID** and **Client Secret**, configure the integration in the Frontegg portal:

1. Open the **Frontegg portal** and navigate to [ENVIRONMENT] → Integrations → Contentful.
2. Enter the **Client ID** and the **Client Secret**.
3. Click **Save**.


Frontegg requests the following scope during authorization:

| Scope | Description |
|  --- | --- |
| `content_management_manage` | Full access to manage content |


Keep your credentials secure
Never share or commit your Client Secret to version control.

### Additional resources

- [Contentful OAuth applications](https://www.contentful.com/developers/docs/references/authentication/#oauth-applications)
- [Content Management API reference](https://www.contentful.com/developers/docs/references/content-management-api/)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)