Regions and base URLs

Kustomer's US, EU and India regions, the org-specific API host, and the other hostnames an integration talks to.

Kustomer runs in three regions: the United States, the European Union and India. Every org lives in exactly one, and its data stays there. API keys and OAuth tokens only work in the region where they were issued.

Use your org host

The simplest rule: always call your org's own API host.

Text
https://<your-org>.api.kustomerapp.com

It routes to the right region automatically, so the same code works for US, EU and India orgs. Your org name is the subdomain you sign in at: acme.kustomerapp.com means acme.

Regional hosts

The API reference also lists the regional hosts. They're useful when you don't know the org name, for example in multi-tenant tools that only store a token.

RegionAPI host
United Stateshttps://api.kustomerapp.com
European Unionhttps://api.prod2.kustomerapp.com
Indiahttps://api.prod4.kustomerapp.com

The Try it panel in the API reference has a region selector with the same options: your org host, US, EU and India.

Other hostnames

HostUsed for
https://<org>.kustomerapp.comThe Kustomer web app, and the OAuth /oauth/authorize endpoint
https://<org>.api.kustomerapp.comREST API and the OAuth /oauth/token endpoint
https://cdn.kustomerapp.comStatic assets, including the web chat SDK at /chat-web/widget.js

If your network filters outbound traffic, allow HTTPS to *.kustomerapp.com.

Multi-region integrations

If you build for many Kustomer orgs, for example a marketplace app:

  • Store the org name with each customer's credentials, and build the base URL from it.
  • Never send one org's token to another org's host.
  • Treat region as a property of the org, not of your deployment. A single deployment can serve US, EU and India orgs.