Skip to main content

Authorization

Follow this guide to create a new Customer.io credential that will allow Nexla to authenticate to and exchange data with your Customer.io workspace.
customer_io_api_auth.png

Customer.io

Prerequisites​

To connect Nexla to Customer.io, you will need an App API Key from your Customer.io workspace. App API Keys are distinct from Tracking API Keys—they are used exclusively for the App API, which provides access to campaigns, newsletters, broadcasts, transactional messages, customer profiles, segments, and more.

Obtain a Customer.io App API Key​

Customer.io App API Keys are generated in your workspace's Account Settings. Each key is shown only once at creation, so be sure to copy and store it securely before closing the dialog.

  1. Sign in to your Customer.io account.

  2. Click your workspace name or account icon in the upper-left corner, then select Account Settings.

  3. In the Account Settings menu, click API Credentials.

  4. Select the App API Keys tab at the top of the API Credentials page.

  5. Click Create App API Key.

  6. Enter a descriptive name for the key (for example, Nexla Integration) and select the workspace this key should apply to.

  7. Click Create to generate the key.

Important

Copy the generated App API Key immediately and store it in a secure location. Customer.io displays the key only once—if you navigate away without copying it, you will need to create a new key.

  1. Note the region of your Customer.io workspace:
    • If your workspace is hosted in the United States, your API region domain is api.customer.io.
    • If your workspace is hosted in the European Union, your API region domain is api-eu.customer.io.

You can verify your workspace region in Customer.io by navigating to Account Settings and checking the data center listed under your workspace information. Selecting the correct region domain ensures your data is routed to the appropriate Customer.io data center and supports GDPR compliance for EU workspaces.

For complete details on managing your Customer.io API credentials, see Manage your API credentials in the Customer.io documentation.

Create a Customer.io Credential​

  • To create a new Customer.io credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used to provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

App API Key (Bearer Token)​

Customer.io authenticates App API requests using a Bearer token—the App API Key you generated in the Prerequisites section above is sent in the Authorization HTTP header on every request.

  1. Enter your Customer.io App API Key in the App API Key field. This key will be sent as a Bearer token (Authorization: Bearer <key>) with each API call Nexla makes to Customer.io on your behalf.

  2. Select the API Region Domain that corresponds to your Customer.io workspace region:

    • api.customer.io — Select this option for workspaces hosted in the United States (this is the default).

    • api-eu.customer.io — Select this option for workspaces hosted in the European Union.

    Selecting the correct region domain is required for successful authentication. If your workspace is in the EU and you use the US domain, your requests may be redirected but data could still pass through US servers.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.