Talon.One

Talon.One Audiences API

Represents lists of customer profiles that allow you to target specific groups of customers in your campaigns. Audiences can be synced from customer data platforms or created directly in Talon.One. See the [docs](https://docs.talon.one/docs/product/audiences/overview).

Documentation GitHub OpenAPI

Business capability

Customer Segmentation Management BC-420.20

Operations 11

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v2/audiences Create an audience · Create audience #

Ask an LLM

“How do I create a customer audience I can target in promotion rules?”

“Can I link a new audience to an audience that already exists in a third-party platform?”

Tell an agent

Create an audience named {name}.

Create audience {name} from integration {integration} with external ID {integrationId}.

DELETE /v2/audiences/{audienceId} Delete an audience · Delete audience #

Ask an LLM

“What happens to customer associations when I delete an audience?”

“How do I get rid of an audience entirely?”

Tell an agent destructive · confirm first

Delete audience {audienceId}.

Permanently remove audience {audienceId} and its profile associations.

PUT /v2/audiences/{audienceId} Rename an audience · Update audience name #

Ask an LLM

“Can I rename an audience that a third-party integration created?”

“Does renaming an audience trigger the Rule Engine?”

Tell an agent

Rename audience {audienceId} to {name}.

Change the name of audience {audienceId} to {name} and subscribe applications {subscribedApplicationsIds}.

DELETE /v2/audiences/{audienceId}/memberships Remove every member from an audience · Delete audience memberships #

Ask an LLM

“Can I empty an audience without deleting the audience itself?”

“Is there a way to clear all members out of an audience at once?”

Tell an agent destructive · confirm first

Remove all members from audience {audienceId}.

Empty audience {audienceId} but keep the audience.

POST /v2/customer_audiences Add or remove customers from audiences in bulk · Update multiple customer profiles' audiences #

Ask an LLM

“How many add or remove audience actions can I send in one request?”

“Can I add several customer profiles to an audience in a single call?”

Tell an agent

Apply these audience add and remove actions: {data}.

Add or remove customer profiles in audiences according to {data}.

PUT /v2/audience_customers/{audienceId}/attributes Set profile attributes for everyone in an audience · Update profile attributes for all customers in audience #

Ask an LLM

“Can I set the same profile attribute value for every customer in an audience?”

“Is there a bulk way to update attributes of all audience members?”

Tell an agent

Update profile attributes for all customers in audience {audienceId}.

Set the given attribute values on every member of audience {audienceId}.

GET /v1/audiences List the account's audiences · List audiences #

Ask an LLM

“Which audiences have been created in my account?”

“Can I get the total number of audiences along with the list?”

Tell an agent

List all audiences in my account.

Show audiences sorted by {sort}, including the total count: {withTotalResultSize}.

GET /v1/audiences/analytics Get member counts for audiences · List audience analytics #

Ask an LLM

“How many members does each of my audiences have?”

“Can I compare member counts for a chosen set of audiences?”

Tell an agent

Show member counts for audiences {audienceIds}.

Get audience size analytics for {audienceIds}.

GET /v1/audiences/{audienceId}/memberships List the customers in an audience · List audience members #

Ask an LLM

“Who is in a particular audience?”

“What's the maximum page size when listing an audience's members?”

Tell an agent

List the members of audience {audienceId}.

Find members of audience {audienceId} matching {profileQuery}.

POST /v1/audiences/{audienceId}/memberships/import Replace an audience's members from a CSV · Import audience members #

Ask an LLM

“How do I upload a CSV of customer IDs into an audience?”

“Does importing audience members replace the existing members?”

Tell an agent

Import audience members from file {upFile} into audience {audienceId}.

Replace the members of audience {audienceId} with the profile IDs in CSV {upFile}.

GET /v1/audiences/{audienceId}/memberships/export Export an audience's members to CSV · Export audience members #

Ask an LLM

“Can I download an audience's member IDs as a CSV file?”

“What column does the audience member export contain?”

Tell an agent

Export the members of audience {audienceId} to CSV.

Download the profile integration IDs in audience {audienceId}.

Talon.One Audiences API

Operations 11

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification