Introduction
Manage your audience programmatically — contacts, custom fields, automations, transactional email, send reports, and webhooks.
Welcome to the Audienceful developer docs. The API v2 lets you do everything the app does — sync contacts, manage custom fields, trigger automations, send transactional emails, pull send reports, and subscribe to webhooks — straight from your own backend.
It's a resource-oriented JSON API with predictable URLs, cursor pagination, a consistent error envelope, and idempotent writes. If you've used a modern REST API before, this will feel familiar.
Base URL
The Audienceful API is located at:
https://api.audienceful.com/v2/
v2 is the current API and all new integrations should use it. Every request is authenticated with an API key in the X-Api-Key header.
Core concepts
Before you write your first request, it's worth skimming the shared conventions that apply across every endpoint.
Resources
Build your own solution for growing and managing your audience. We're continually adding functionality to the public API as we ship improvements and new features.
Can't find an endpoint for what you need? Let us know and we'll make it available as soon as possible.
OpenAPI & SDKs
A machine-readable OpenAPI 3 schema covering the public v2 endpoints is served at https://api.audienceful.com/v2/openapi.json. Use it to generate a typed SDK in your language of choice, import the API into Postman or Insomnia, or keep your own reference in sync.