Create, search, and manage audiences. Audiences are named groups of contacts used for targeting and syncing to ad platforms.
Get audience
Retrieve a single audience by its unique identifier. Returns the audience name, status, description, tracking UTM value, and creation timestamp.
path Parameters
audience_idGet audience › Responses
Successful Response
The audience details.
Search audiences
Search audiences within your organization with an optional name filter. Results are paginated.
Search audiences › Request Body
Filter audiences by name (partial match)
pagePage number (1-indexed)
page_sizeNumber of results per page
Search audiences › Responses
Successful Response
List of audiences matching the search criteria
Search audience contacts
Search contacts that belong to a specific audience. Apply optional filters on name, job title, company, location, and more. Results are paginated.
Search audience contacts › Request Body
audience_idThe audience to search contacts within.
Filter by contact's first name.
Filter by contact's last name.
Filter by job title.
Filter by functional area (e.g. Engineering, Marketing, Sales).
Filter by company name.
Filter by company domain.
Filter by city.
Filter by state or region.
Filter by country.
Filter by postal code.
Filter by LinkedIn profile URL.
pagePage number (1-indexed).
page_sizeNumber of results per page.
Search audience contacts › Responses
Successful Response
Contacts belonging to the audience that match the filters.
totalTotal number of matching audience contacts.
pageCurrent page number.
page_sizeNumber of results per page.
Create audience export
Create an async audience export job. V1 supports contactRecords CSV exports.
path Parameters
audience_idCreate audience export › Request Body
export_typeThe type of audience export to create.
formatThe file format to generate.
Optional boolean field map. Missing field keys default to false.
Create audience export › Responses
Successful Response
export_idThe export job id.
audience_idThe audience being exported.
export_typeThe export type.
formatThe export format.
statusThe export status.
Get audience export
Fetch an audience export job status and its presigned download URL when ready.
path Parameters
export_idGet audience export › Responses
Successful Response
export_idThe export job id.
audience_idThe audience being exported.
export_typeThe export type.
formatThe export format.
statusThe export status.
row_countThe number of rows written.
The generated file name.
A presigned download URL when the export is completed.
Expiration timestamp for the presigned download URL.
Safe error message when the export failed.
Create audience
Create an audience without configuring or running destination syncs.
Create audience › Request Body
nameName for the new audience.
Optional description of the audience.
Create audience › Responses
Successful Response
The created audience.
Add contact to audience
Add an existing contact to an audience. The contact must belong to the same organization.
Add contact to audience › Request Body
audience_idThe audience to add the contact to.
contact_idThe contact to add.
Add contact to audience › Responses
Successful Response
successWhether the contact was successfully added.
Additional information about the result.
Remove contact from audience
Remove a contact from an audience. The contact is not deleted — only the audience membership is removed.
Remove contact from audience › Request Body
audience_idThe audience to remove the contact from.
contact_idThe contact to remove.
Remove contact from audience › Responses
Successful Response
successWhether the contact was successfully removed.
Additional information about the result.