younifyd
Menu

Update Audience V2

Update audience name

PUT/v2/audiences/{audienceId}

Use it in a workflow

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

Request

Path parameters

audienceIdinteger (int64)required

The ID of the audience.

Request body

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

namestringrequired

The human-friendly display name for this audience.

json
{
  "name": "Travel audience"
}

Response

Returns 200 with an object. Read it in later steps with {{updateAudienceV2.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

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
{
  "accountId": 3886,
  "id": 6,
  "created": {},
  "name": "Travel audience",
  "sandbox": true,
  "description": "Travel audience 18-27",
  "integration": "mparticle",
  "integrationId": "382370BKDB946",
  "createdIn3rdParty": false,
  "lastUpdate": {}
}

Need more? See the Talon.One guide for connection setup and behaviour shared by every action.