API Reference
Audiences
Create, organize, update, and read audiences and audience prospects.
Audience readiness
Audiences with active prospecting jobs are not ready for use. Reading a single audience or its prospects returns 409 AUDIENCE_NOT_READY; list audiences silently excludes audiences still being populated.
Folder and ownership rules
Audience and folder mutations require audiences:write and preserve account-group ownership, monitoring restrictions, and folder compatibility rules from the product UI.
Audiences
Create, list, inspect, update, delete, and navigate audiences.
/v1/accounts/{accountGroupId}/audiencesList audiences (imported lists)
/v1/accounts/{accountGroupId}/audiencesCreate an audience
/v1/accounts/{accountGroupId}/audiences/{audienceId}Delete an audience
/v1/accounts/{accountGroupId}/audiences/{audienceId}Get a single audience
/v1/accounts/{accountGroupId}/audiences/{audienceId}Update an audience
/v1/accounts/{accountGroupId}/audiences/navigationGet grouped audience navigation
Movement
Move leads between audiences or move audiences in and out of folders.
/v1/accounts/{accountGroupId}/audiences/{audienceId}/move-leadsMove leads between audiences
/v1/accounts/{accountGroupId}/audiences/{audienceId}/move-to-folderMove an audience into a folder
/v1/accounts/{accountGroupId}/audiences/{audienceId}/remove-from-folderMove an audience out of a folder
Prospects
Read the prospects contained in an audience.
Folders
Create, rename, delete, and navigate audience folder structures.