# General Translation Integrations: Connection settings
URL: https://generaltranslation.com/en-GB/docs/integrations/storyblok/reference/connection.mdx
---

title: Connection settings
description: Reference for the settings used to connect a Storyblok space to General Translation. API reference for the Storyblok connection settings.

---

The settings used to connect a Storyblok space to General Translation. You provide them once in the **Connect** dialogue under **Project > Integrations**; General Translation stores them on the Project 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 on the Project that connected them. Each Project connects its own Storyblok space; credentials are not shared across Projects. They remain there until the integration is disconnected.

## Plan and permission gating [#gating]

Connecting a Storyblok integration requires both:

* **Permission:** `project:write` on the Project.
* **Plan feature:** the `project_integrations` feature on the Project's plan.

When the plan feature is missing, the Dashboard shows an upgrade prompt (with the required plan) in place of the integrations catalogue, so the **Connect** action cannot be accessed. Without `project:write`, the **Connect** action is unavailable. The `project_integrations` gating also applies to running translations; the connect and translation server actions return the error "Integrations are not available on your current plan." when the feature is missing.