Skip to main content

Generate an Iterable Server-Side API Key

Iterable uses API keys to authenticate requests. For a connector integration you need a “Server-side” API key with read/write access to the project’s API endpoints.

1

Sign in to Iterable

Open your Iterable workspace at app.iterable.com (US) or app.eu.iterable.com (EU) and sign in.

2

Open the API Keys page

Iterable’s API keys live under the Integrations section of the left sidebar.

  • In the left sidebar, click Integrations to expand the section.
  • Click API Keys under Integrations.
3

Create a Server-Side API Key

Generate a new key with the correct permissions.

  • Click + New API key in the top right of the API Keys page.
  • Give the key a descriptive Name (e.g. “StackOne Integration”).
  • Open the Type dropdown and choose Server-side (under the SERVER-SIDE heading) — this grants read/write access to all server-side API endpoints.
  • Click Create API key.
  • In the “Copy your new API key” dialog, click the copy button next to the key value and store it securely. After you close this dialog, Iterable will only show the key’s last 8 characters — if you lose the full value you must create a new key.

Identify Your Iterable Region

Iterable runs two regional data centers. Each project is bound to one DC at creation time. Pick the region that matches your project’s URL.

1

Determine Region from Workspace URL

The workspace URL identifies your data center.

  • If your workspace URL begins with app.iterable.com choose United States.
  • If your workspace URL begins with app.eu.iterable.com choose European Union.

Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • API Key
  • Region
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.