Data regions

Gleap offers two data regions: EU (default) and US. You choose the region when you sign up, and your customer databases, uploaded files and backups stay in the selected region. EU accounts use EU AI endpoints and US accounts use US AI endpoints. Separate provider processing outside that region is described below. Each region has its own API, websocket, realtime and file hosts. If your project lives in the EU region, there is nothing to do: every SDK and all API examples in this documentation use the EU hosts by default. If your project lives in the US region, you need to

tell the SDK which region to use with one call before initialize (see Select the region in the SDK), and
send your REST API and server-to-server requests to the US API host (see REST API and server-to-server).

Data residency covers regional customer-content hosting. AI, email, integrations, monitoring, account administration and other providers may process data outside the selected region. Review the residency scope and sub-processor schedule before enabling features with location requirements.

Hosting locations

The EU region is hosted on DigitalOcean in Frankfurt, Germany. The US region is hosted in DigitalOcean’s NYC3 data center in New York, United States. These locations describe regional hosting; separate provider processing is described in the sub-processor schedule.

Hosts per region

These hosts are region specific. They store or process customer content for projects of that region only.

Purpose	EU (default)	US
API	`api.eu.gleap.ai` (legacy: `api.gleap.io`)	`api.us.gleap.ai`
Dashboard API	`dashapi.eu.gleap.ai` (legacy: `dashapi.gleap.io`)	`dashapi.us.gleap.ai`
SDK websocket (session and event streaming)	`ws.eu.gleap.ai` (legacy: `ws.gleap.io`)	`ws.us.gleap.ai`
Realtime (conversations and notifications)	`sockets.eu.gleap.ai` (legacy: `sockets.gleap.io`)	`sockets.us.gleap.ai`
Files	`files.gleap.io`	`files.us.gleap.ai`
Static files	`staticfiles.gleap.io`	`staticfiles.us.gleap.ai`

The EU region is served on *.eu.gleap.ai. The native SDKs (iOS, Android and the wrappers built on them) use these hosts by default from v18; the JavaScript SDK keeps the *.gleap.io hosts as its EU default for now, so existing Content Security Policies keep working — allow *.gleap.ai in your CSP today so a later release can switch without any change on your side. The legacy api.gleap.io, dashapi.gleap.io, ws.gleap.io and sockets.gleap.io hosts keep working and point at the same EU region, so existing integrations and older SDK versions need no change.

Global hosts

The following hosts are the same for every region. They serve shared apps and static assets. Their global availability does not change the selected customer-content region; delivery services may still process connection metadata outside that region.

Host	Purpose
`sdk.gleap.io`	JavaScript SDK
`messenger-app.gleap.io`	Messenger app loaded by the SDKs
`js.gleap.io`, `static.gleap.io`, `outboundmedia.gleap.io`	Static assets
`app.gleap.io`	Gleap dashboard

Using a Content Security Policy or a firewall allowlist? Allow both *.gleap.io and *.gleap.ai. See Content Security Policy (CSP) for the full list of directives.

How do I know my region?

Open your project in the Gleap dashboard and navigate to the project settings. The data region of the project is shown next to the API token.

Residency, transfers and compliance

GDPR (DSGVO) obligations apply where required by law in either region. Gleap’s DPA governs processing on behalf of customers, including international-transfer safeguards. A US region selection does not waive GDPR protections, and an EU region selection does not guarantee EU-only processing by every provider. AI processing includes supporting services such as embeddings, reranking, document conversion and code sandboxes. Check the provider-specific scope as well as the selected model. See EU and US data residency for details and security practices for the SOC 2 Type II report’s scope and period.

Existing accounts and migration

Changing setRegion, an API URL or a dashboard region selection does not copy or migrate your existing data. Use the region assigned to your project. Contact privacy@gleap.io before changing an existing account’s residency requirements. Existing contractual restrictions remain in force until validly amended.

Select the region in the SDK

SDK v18.0.0 adds setRegion on all platforms. It sets the API, websocket and realtime hosts together and must be called before initialize. The default region is eu, so EU projects don’t need to call it.

Gleap.setRegion("us");
Gleap.initialize("API_KEY");

When using the code snippet, add window.Gleap.setRegion("us"); right before window.Gleap.initialize("API_KEY").

// Swift
Gleap.setRegion("us")
Gleap.initialize(withToken: "API-TOKEN")

// Objective-C
[Gleap setRegion:@"us"];
[Gleap initializeWithToken: @"API-TOKEN"];

Gleap.getInstance().setRegion("us");
Gleap.initialize("YOUR_API_KEY", this);

Gleap.setRegion("us");
Gleap.initialize("Your_TOKEN");

await Gleap.setRegion(region: 'us');
Gleap.initialize(token: 'YOUR_API_KEY');

Gleap.setRegion({ region: "us" });
Gleap.initialize("API_KEY");

FlutterFlow apps use the Flutter SDK, so the Flutter call applies. Data regions are not supported by the Cordova, Unity, .NET MAUI and Windows Desktop SDKs yet.

Order rule and manual host setters

setRegion is all you need in almost every setup. The manual host setters still exist for special cases (for example when you route Gleap traffic through your own proxy):

Setter	Host
`setApiUrl`	API
`setWSApiUrl`	SDK websocket
`setRealtimeHost`	Realtime
`setFrameUrl`	Messenger app
`setBannerUrl`	Banners
`setModalUrl`	Modals

The JavaScript SDK offers all of them; the native SDKs gain the same setters in v18. The order matters:

Call setRegion before initialize.
A manual setter called after setRegion overrides that single host. All other hosts keep the value of the selected region.
setRegion called after setApiUrl, setWSApiUrl or setRealtimeHost replaces these three hosts with the region’s hosts again, so always call setRegion first.

Gleap.setRegion("us");
// Optional: override a single host after selecting the region.
Gleap.setApiUrl("https://gleap-proxy.example.com");
Gleap.initialize("API_KEY");

REST API and server-to-server

The base URL of the REST API, the server-side event tracking API and the Conversations API (server-to-server) is the API host of your region:

Data region	API host
EU (default)	`https://api.gleap.io`
US	`https://api.us.gleap.ai`

# US region
curl -X GET https://api.us.gleap.ai/v3/tickets \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Project: YOUR_PROJECT_ID"

API tokens are per project and only valid in the project’s region. A token does not work against the API host of another region.

Get Started

SDKs

Kai Code

Server-side event tracking

Guides

Hosting locations

Hosts per region

Global hosts

How do I know my region?

Residency, transfers and compliance

Existing accounts and migration

Select the region in the SDK

Order rule and manual host setters

REST API and server-to-server

​Hosting locations

​Hosts per region

​Global hosts

​How do I know my region?

​Residency, transfers and compliance

​Existing accounts and migration

​Select the region in the SDK

​Order rule and manual host setters

​REST API and server-to-server

Hosting locations

Hosts per region

Global hosts

How do I know my region?

Residency, transfers and compliance

Existing accounts and migration

Select the region in the SDK

Order rule and manual host setters

REST API and server-to-server