# General Translation Integrations: Connection settings
URL: https://generaltranslation.com/en-GB/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 > Catalogue**. 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 where the space is hosted.  | `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 in 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 where your Storyblok space is hosted. Select it 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 unrecognised 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 > 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 must have access to the space's stories and components, because the integration reads stories, reads and updates story content, and (for [Auto-enable supported fields](/docs/integrations/storyblok/guides/translating-content#auto-enable)) reads and 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 catalogue, so the **Connect** action cannot be accessed. 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.