Skip to main content
Select Actions to adjust the guide
Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.
Action
Scope(s)
Loading actions…
Dynamic Guide URL
Scopes Selected
Separator
​
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
Sign in to Contentful
Sign in to your Contentful account.
  • Click your profile avatar in the top-right corner and select Account settings.
2
Open the OAuth applications page
Navigate to the OAuth applications tab in Account settings.
  • Click + Create application in the top-right of the OAuth applications page.
3
Fill in the application details
Provide the application name, description, redirect URI, and expiration date.
  • Name: e.g., StackOne
  • Description: Enter a description for the application, e.g., StackOne integration (required).
  • Redirect URI: https://api.stackone.com/connect/oauth2/contentful/callback
  • Expiration date: Set the token expiration duration (required, default: 30 days).
  • Check Confidential — required because StackOne authenticates using the Client ID and Client Secret. If left unchecked, the app becomes a public client and the connection will fail.
  • Check Manage if you plan to use the content_management_manage scope (this already includes read access, so the Read checkbox is not needed), or check Read alone if you plan to use content_management_read. The checkbox must match the scope you request — leaving the matching checkbox unchecked causes an authorization error.
  • Click Create application.
4
Copy the Client ID and Client Secret
Contentful displays the Client ID and Client Secret on the application details page.
  • Copy the Client ID and the Client Secret. Store them securely for use later.


​
Select an OAuth scope
Choose the scope that the OAuth application will request. content_management_manage grants full read and write access; content_management_read is read-only. Scopes are entered on the StackOne side, not in Contentful.
1
Choose a scope
Enables actions: Create Organization Invitation, Create Personal Access Token, Create Role, Create Space, Create Space Membership, Create Team, Create Team Membership, Create Team Space Membership, Delete Organization Membership, Delete Role, Delete Space, Delete Space Membership, Delete Team, Delete Team Membership, Delete Team Space Membership, Get Current User, 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, Revoke Personal Access Token, Update Organization, Update Organization Membership, Update Role, Update Space, Update Space Add-ons, Update Space Membership, Update Team, Update Team Space Membership
Contentful accepts only a single scope per OAuth request — providing multiple values returns an authorization error. Pick one scope based on the operations your connection needs and enter it in the Scopes field when creating the Connector Profile in StackOne.
  • content_management_manage — full read and write access. Already includes read access, so do not also request content_management_read.
  • content_management_read — read-only access.


​
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.