Create Audience V2

Create audience

POST/v2/audiences

Use it in a workflow

Add a step and choose the Talon.One connector.
Pick the Create Audience V2 action (under integration).
Fill in the fields below, then reference the result from later steps as {{createAudienceV2.response.data}}.

Request

Request body

Enter the body as JSON in the step's Body field.

namestringrequired

The human-friendly display name for this audience.

sandboxboolean

Indicates if this is a live or sandbox Application.

descriptionstring

A description of the audience.

integrationstring

The Talon.One-supported [3rd-party platform](https://docs.talon.one/docs/dev/technology-partners/overview) that this audience was created in. For example, `mParticle`, `Segment`, `Shopify`, `Braze`, or `Iterable`. **Note:** If you do not integrate with any of these platforms, do not use this property.

integrationIdstring

The ID of this audience in the third-party integration. **Note:** To create an audience that doesn't come from a 3rd party platform, do not use this property.

createdIn3rdPartyboolean

Determines if this audience is a 3rd party audience or not.

lastUpdatestring (date-time)

The last time that the audience memberships changed.

json

{
  "name": "Travel audience",
  "sandbox": true,
  "description": "Travel audience 18-27",
  "integration": "mparticle",
  "integrationId": "382370BKDB946",
  "createdIn3rdParty": false,
  "lastUpdate": {}
}

Response

Returns 201 with an object. Read it in later steps with {{createAudienceV2.response.data.<field>}}.

accountIdinteger (int64)

The ID of the account that owns this entity.

idinteger (int64)

The internal ID of this entity.

createdstring (date-time)

The time this entity was created.

namestring