Iterable - Integration Document

Written By Devin O'Neill ()

Updated at April 16th, 2025

Regions

Region Region Id
Europe r1
North America r2
Asia Pacific r3

Categories

There are two different categories that are used to separate and use all APIs.

  1. Lists
  2. Contacts

API for Iterable Library

The following APIs are used for libraries.

Lists

The list means it is a group of contacts. We can call the list a segment. One account has multiple lists.

Get all Lists

Method URL
GET: Get all lists https://api.iterable.com/api/lists
Header Parameters
  1. Content-Type: application/json
  2. api_key: {{api_key}}

Add Contact to List

Method URL
POST: Add Contact to List https://api.iterable.com/api/subscribe
Header Parameters
  1. Content-Type: application/json
  2. api_key: {{api_key}}
Post Data {{data array}}

Contacts

In Contacts, we used five APIs and they are as follows:

Add Contact

Method URL
POST: Add contact https://api.iterable.com/api/ users/update
Header Parameters
  1. Content-Type: application/json
  2. api_key: {{api_key}}
Post Data {{data array}}

Update Contact

Method URL
POST: Update contact https://api.iterable.com/api/ users/update
Header Parameters
  1. Content-Type: application/json
  2. api_key: {{api_key}}
Post Data {{data array}}

Get Contact Details by Email

Method URL
GET: Get contact details using an email address https://api.iterable.com/api/ users/{{email_address}}
Header Parameters
  1. Content-Type: application/json
  2. api_key: {{api_key}}

API Operations

  • To get all lists, use the "Get all lists" API
  • To add the contact to the list, use the "Add contact into list" API.
  • To add the contact to the account, use the "Add contact" API.
  • To update contact into account, use "Update contact" API
  • To get contact details, use the "Get contact details by email" API.

Credentials Required

  • API URL - https://api.iterable.com/api /
  • API Key - 99bf0a2b3be844299f0b05aababf1aa1

Login Credentials

Credentials 1:

https://app.iterable.com/login

Username: custintegrations@annexcloud.com

Password: .wH4uAqkeXgG*Xi