Skip to main content
You must select a license region when you create a tenant app. A license region is a host-managed record identified by a region code. It is used during app creation to resolve the region-specific database metadata the app needs later for token issuance.

​
What Happens During App Creation

At app creation time, the backend:
  1. validates that the region code exists
  2. checks that the region is active
  3. loads the active region database for that region
  4. stamps the app with both LicenseRegionId and DbCode

​
Why This Matters

License region data is part of the token issuance path for tenant apps.
  • token issuance requires a license region
  • token issuance also requires the stamped DbCode
  • licenseRegionCode is added to the access token
  • dbCode is added to the access token
  • the selected region is used to choose the database where the app’s license and usage data is stored

​
When App Creation Fails

App creation fails if:
  • the region code does not exist
  • the region is inactive
  • the region has no active region database

​
Can The Region Be Changed Later

The current tenant app update flow does not expose license region changes. In practice, treat region selection as a create-time decision.
If you need a different region, the safe path is to create a new app with the target region and move traffic to the new credentials.
Last modified on April 1, 2026