Skip to content
Docs
or

Nylas data residency

Nylas’ data residency offering enables you to comply with legal requirements related to storing personally identifiable information (PII) in different regions around the world. As your data sub-processor, Nylas provides the tools and controls necessary to manage and configure where user data is stored. Nylas offers storage in two regions: the U.S. and Europe.

Because each region is completely isolated, data cannot pass between them. You must create, configure, and manage a separate Nylas organization for each region that you want to store user data in. Your Nylas application must also be aware of which region a user belongs to, so it queries the appropriate APIs.

The tables below show information about Nylas’ data centers.

In Nylas v3, all information about your Nylas organizations and your Nylas Dashboard users is stored in the European data center. When users in the U.S. access the Nylas Dashboard, their authorization is processed through the server in Ireland. Your application data, connector data, and grant information (your end users’ data), however, is stored in the data center associated with your Nylas application.

Get started with a new region

The steps to set up data residency with Nylas are the same for all regions:

  1. Create a new Nylas organization using the appropriate Dashboard URL.
  2. Configure your Nylas application in the new organization.
  3. Configure your applications’ code to query the API endpoints associated with the regional data center for accounts or grants in that region.

These steps are the same as those outlined in Develop with Nylas, but there is one key difference: you must query the Nylas API that matches your end user’s region (for example, you can’t query api.nylas.com for a user in Ireland).

An infographic showing which Nylas data center you should store your end users' data in.

Configure base API URL in Nylas SDKs

The Nylas SDKs support changing the base API URL, as in the example below. Be sure to use the appropriate URL for your Nylas organization’s region.

const NylasConfig = {
  apiKey: "<NYLAS_API_KEY>",
  apiUri: "<NYLAS_API_URI>",
};


const nylas = new Nylas(NylasConfig);