Data regions

Gleap offers two data regions: EU (default) and US. You choose the region when you sign up, and your customer content is stored and processed in the selected region. 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).

Depending on the AI models you enable for your project, third-party AI model providers may process content outside of the selected region.

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 only serve static assets and apps and do not store customer content.

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.

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

Hosts per region

Global hosts

How do I know my region?

Select the region in the SDK

Order rule and manual host setters

REST API and server-to-server

​Hosts per region

​Global hosts

​How do I know my region?

​Select the region in the SDK

​Order rule and manual host setters

​REST API and server-to-server

Hosts per region

Global hosts

How do I know my region?

Select the region in the SDK

Order rule and manual host setters

REST API and server-to-server