# General Translation Integrations: Connection settings
URL: https://generaltranslation.com/en-US/docs/integrations/storyblok/reference/connection.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Reference for the settings used to connect a Storyblok space to General Translation. API reference for the Storyblok connection settings.

You provide the connection settings once from **Project > Integrations > Catalog**. General Translation stores them in an Organization connection and uses them to call the Storyblok Management API.

## Overview [#overview]

| Setting | Description | Type | Optional | Default |
| --- | --- | --- | --- | --- |
| [Space ID](#space-id) | The numeric ID of the Storyblok space. | `string` | No | — |
| [Region](#region) | The region the space is hosted in. | `eu` \| `us` \| `ca` \| `ap` \| `cn` | No | `eu` |
| [Personal access token](#access-token) | A Storyblok Management API token. | `string` | No | — |

Connecting also requires meeting the [plan and permission gating](#gating) below.

## Space ID [#space-id]

**Type** `string` · **Required**

The numeric ID of the Storyblok space, shown in Storyblok under **Settings > General**. Entered in the **Space ID** field, which accepts numeric input. A leading `#` is stripped and surrounding whitespace is trimmed before the value is stored.

The space ID is stored both as the integration's resource identifier and inside the credentials. A translation run fails if the credential space ID does not match the connected integration.

## Region [#region]

**Type** `eu` | `us` | `ca` | `ap` | `cn` · **Required** · **Default** `eu`

The region your Storyblok space is hosted in. Selected in the **Region** field, which offers **EU**, **US**, **CA**, **AP**, and **CN**. The region determines which Storyblok Management API base URL the integration calls:

| Region | Management API base URL |
| --- | --- |
| `eu` | `https://mapi.storyblok.com/v1` |
| `us` | `https://api-us.storyblok.com/v1` |
| `ca` | `https://api-ca.storyblok.com/v1` |
| `ap` | `https://api-ap.storyblok.com/v1` |
| `cn` | `https://app.storyblokchina.cn/v1` |

An unrecognized region is rejected when connecting.

## Personal access token [#access-token]

**Type** `string` · **Required**

A Storyblok personal access token (a Management API token), created in Storyblok under **My account > Account settings > Personal access tokens**. Entered in the **Personal access token** field, which is masked.

The token is sent as the `Authorization` header on every Management API request the integration makes. It needs:

- **Spaces** read access, because the integration loads the space when connecting and reading stories.
- **Stories** write access, because the integration reads stories and updates story content.
- **Components** read access, because the integration reads component schemas. Grant write access if you use [Auto-enable supported fields](/docs/integrations/storyblok/guides/translating-content#auto-enable), which updates component schemas.

## Storage [#storage]

Credentials — the space ID, region, and personal access token — are stored once on an Organization connection keyed to the Storyblok space. The project integration links to that connection. The connection record is visible under **Organization > Connections**.

## Plan and permission gating [#gating]

Connecting a Storyblok integration requires both:

- **Permission:** `project:write` on the project.
- **Plan:** Starter or Enterprise.

Without a supported plan, the Dashboard shows an upgrade prompt in place of the integrations catalog, so the **Connect** action is not reachable. Without `project:write`, the **Connect** action is unavailable. Running translations also requires `translations:content:write` and the same plan feature; the connect and translation actions reject requests from unsupported plans.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.