Audiences Create

• namestring
  Audience display name. Required for custom audiences; lookalike names are generated from the source audience.
• countinteger
  Lookalikes only. Number of lookalike audiences to create (1–6).
• intentstring

  Required
  The original user request that led to this tool call. Copy it verbatim when available.
• file_idstring
  CSV audiences only. The uploaded customer CSV — a file id (`file_...`) returned by `POST /files`.
• filtersobject
  Filter audiences only. The People filters that define membership, keyed exactly as `GET /people` accepts them — for example `{"os": "iOS", "country": "US"}`. Activity dates `event_from` and `event_to` are inclusive and remain fixed on refresh. Use `event_within_days`, `first_see…
• intent_idstring

  Required
  A UUID for the user turn that caused this call. Generate it once per user message and reuse it for every tool call made to fulfill that message. Never derive it from the intent text.
• account_idstring
  Account ID, prefixed `biz_`.
• engagementobject
  Rules for membership based on social engagement. Requires a connected social account with advertising access.
• percentageinteger
  Lookalikes only. Total similarity reach as a whole percent (1–20), sliced evenly across `count` — must be divisible by `count`. For example, 3 audiences at 6% creates 0–2%, 2–4%, and 4–6% bands.
• source_typestring
  Custom audience source. Inferred from `engagement`, then `filters`, otherwise defaults to `csv_upload`. Supply only the fields for the selected source.
• auto_refreshboolean
  Filter audiences only, and set only at creation. `true` (the default) rebuilds membership from the filters twice a day. `false` keeps whoever matched at creation and never rebuilds.
• audience_typestring
  Audience type. Defaults to `custom`.

No reviewed structured output summary is available.

No verified related use cases are linked yet.

No published Skills explicitly reference this Action yet.