Skip to main content

​
Register an OAuth application in Contentful

Create an OAuth application in your Contentful account to obtain the Client ID and Client
Secret needed for the connection.

1

Navigate to OAuth applications

Sign in to your Contentful account. Click your profile
avatar in the top-right corner, select Account settings, then click
OAuth applications in the top navigation.

  • Click + Create application in the top-right corner of the OAuth applications page.
OAuth Applications page with Create application button highlighted
2

Fill in the application details

Enter a descriptive Name for the application (e.g., StackOne) and a brief
Description (e.g., StackOne integration).

New application form with Name field highlighted
3

Set the Redirect URI

Paste the StackOne callback URL into the Redirect URI field. This is required for
the OAuth authorization code flow to complete.

  • Redirect URI: https://api.stackone.com/connect/oauth2/contentful/callback
  • Expiration date: Required — defaults to 30 days. Choose a duration suitable for your integration.
New application form with Redirect URI filled in and highlighted
4

Configure permissions and save

Select the appropriate scope checkboxes and ensure Confidential is checked before
creating the application.

  • Check Manage to grant full read and write access (content_management_manage scope includes read, so the Read checkbox is not required when Manage is checked). Check Read alone if you only need read-only access.
  • Ensure Confidential is checked — required for StackOne to authenticate using the Client ID and Client Secret. Leaving it unchecked makes the app a public client and the connection will fail.
  • Click Create application.
Application form showing Read, Manage, and Confidential checkboxes highlighted
5

Copy the Client ID and Client Secret

After saving, the application page shows the Client ID and Client secret. Copy
both values and store them securely — you will need them when configuring the StackOne
connection.

  • Click the copy icon next to Client ID and store it securely.
  • Click the copy icon next to Client secret and store it securely.
Application details page showing Client ID and Client Secret fields highlighted (values redacted)

​
Select an OAuth scope

Choose the scope the OAuth application will request. Contentful accepts only a single scope
per OAuth request — providing multiple values returns an authorization error. Enter the chosen
scope in the Scopes field when creating the connection in StackOne.

1

Choose a scope

Enables actions: Activate Content Type, Create Asset, Create Content Type, Create Entry, Create Organization Invitation, Create Personal Access Token, Create Role, Create Space, Create Space Membership, Create Team, Create Team Membership, Create Team Space Membership, Deactivate Content Type, Delete Asset, Delete Content Type, Delete Entry, Delete Organization Membership, Delete Role, Delete Space, Delete Space Membership, Delete Team, Delete Team Membership, Delete Team Space Membership, Get All Assets, Get All Content Types, Get All Entries, Get Asset, Get Content Type, Get Current User, Get Entry, Get Organization, Get Organization Invitation, Get Organization Membership, Get Organization User, Get Personal Access Token, Get Role, Get Space, Get Space Add-ons, Get Space Eligible Licenses, Get Space Member, Get Space Membership, Get Space User, Get Team, Get Team Membership, Get Team Space Membership, List Organization Access Tokens, List Organization Available Licenses, List Organization Memberships, List Organization Periodic Usages, List Organization Team Memberships, List Organization Teams, List Organization Users, List Organizations, List Personal Access Tokens, List Roles, List Space Members, List Space Memberships, List Space Periodic Usages, List Space Users, List Spaces, List Team Memberships In Team, List Team Space Memberships In Space, List Teams In Space, Process Asset, Publish Asset, Publish Entry, Revoke Personal Access Token, Unpublish Asset, Unpublish Entry, Update Asset, Update Content Type, Update Entry, Update Organization, Update Organization Membership, Update Role, Update Space, Update Space Add-ons, Update Space Membership, Update Team, Update Team Space Membership

Pick one scope based on the operations your connection needs. Enter it in the Scopes
field when creating the connection in StackOne.

  • content_management_manage — full read and write access. Already includes read, so do not also request content_management_read. The Manage checkbox must be checked in the Contentful OAuth application.
  • content_management_read — read-only access. The Read checkbox must be checked in the Contentful OAuth application.

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Contentful:
1

Navigate to Connector Profiles

Login to StackOne and navigate to Connector Profiles
2

Create New Connector Profile

  • Click + Connector Profile
  • Search for and select Contentful
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scopes (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Contentful.