New API endpoints and enhancements

October 27, 2025

We've made some updates to the Iterable API that we're sure you'll love! Don't worry - these new endpoints and enhancements have no breaking changes to accommodate. Here's what's new:

Campaigns API:

• New endpoint: Get campaign details by campaign ID - GET /api/campaigns/{id}

Lists API:

• DELETE /api/lists/{listId} This endpoint has been updated to return a 409 Conflict response code and a message indicating where the list is active when attempting to delete a list that is in use.

Templates API:

• New template proof API endpoints for email, push, SMS, and in-app templates:

  • POST /api/templates/email/proof
  • POST /api/templates/push/proof
  • POST /api/templates/sms/proof
  • POST /api/templates/inapp/proof

• New template preview endpoints to generate previews of email and in-app templates with custom data via API:

  • POST /api/templates/email/preview
  • POST /api/templates/inapp/preview

Users API:

• POST /api/users/updateSubscriptions Updated to include a new optional parameter, validateChannelAlignment. This parameter defaults to true when it is not provided (this is the default behavior before the parameter was introduced). Providing a value of false will bypass validation and allow message types to be subscribed to even when the user is unsubscribed from the corresponding channel (this is an enhancement).

• New optional behavior for certain Users API endpoints to return all implied subscriptions instead of just explicit subscriptions. This is an enhancement that your account manager can enable for your project. To learn more, see Implied subscriptions in User API responses

Subscription Preference Center impacts:

Some of these API updates impact the way the Users API returns subscription data, and how you can manage user subscriptions in a subscription preference center. To learn more, see:

• Using implied subscriptions in your preference center (optional).
• Validating channel alignment for message type subscriptions (optional).