Skip to content
Last updated

Storyblok integration

Storyblok is a headless content management system (CMS) with a visual editor. Integrating Storyblok with Frontegg lets your application read and manage stories, components, assets, and other content through the Storyblok Management API on behalf of your users — all through Frontegg's integration layer. You can authenticate with either OAuth 2.0 (recommended when connecting on behalf of multiple users) or a Personal Access Token.


Prerequisites

  • A Storyblok space hosted in the European Union region. Spaces hosted in the US, Canada, Australia, or China are not currently supported, because Storyblok serves those regions from different API hosts. You can confirm your space's region in your Storyblok space settings.
  • For OAuth: access to the Storyblok Partner Portal to create a plugin
  • For a Personal Access Token: access to My Account at app.storyblok.com
  • Note: Storyblok rate-limits the Management API to 3 requests per second on the Starter plan and 6 on Growth and above

Connect to Storyblok with OAuth

You create a plugin in the Storyblok Partner Portal and configure OAuth 2 on it. The plugin provides the Client ID and Client Secret and defines the redirect URI that Storyblok returns users to after they authorize access.

Step 1: Create a plugin

Sign in to the Storyblok Partner Portal and create a new Space Plugin (or Tool Plugin). Give it a descriptive name, for example Frontegg Integration.

Step 2: Configure OAuth 2

Open the plugin's settings and go to the OAuth 2 section:

  • Redirect URI — Enter your Frontegg Redirect URL: https://YOUR_MCP_GATEWAY_URL/integration-callback
  • Scopes — Grant read_content and write_content (see the scopes table below).

Step 3: Copy the Client ID and Client Secret

Storyblok displays the Client ID and Client Secret in the plugin settings. 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.

Use a Personal Access Token instead

If you are connecting a single account rather than authorizing multiple users, you can use a Personal Access Token instead of an OAuth app:

  • Go to My Account at app.storyblok.com and click Generate new token.
  • Copy the token. It grants broad access to your account, so store it securely.

A Personal Access Token grants access to every space in your account, while OAuth authorizes one space at a time — choose OAuth if you want to scope access to a single space.

Configure the Frontegg portal

Configure the integration in the Frontegg portal using the method you chose:

  1. Open the Frontegg portal and navigate to [ENVIRONMENT] → Integrations → Storyblok.
  2. For OAuth, enter the Client ID and Client Secret. For a Personal Access Token, enter the token in the Personal Access Token field instead.
  3. Click Save.

The OAuth app grants the following scopes:

ScopeDescription
read_contentRead access to content
write_contentWrite access to content

Keep your credentials secure

Never share or commit your Client Secret or Personal Access Token to version control.

Additional resources