# General Translation Integrations: Connection settings
URL: https://generaltranslation.com/en-US/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** dialog at **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 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 > 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 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 catalog, so the **Connect** action is not reachable. 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.