Skip to main content
POST
Activate an ad-platform audience

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Path Parameters

platform
enum<string>
required
Available options:
facebook,
google,
tiktok,
linkedin,
snapchat,
pinterest,
reddit,
the_trade_desk,
criteo

Body

application/json

Audience activation request. platform comes from the URL param and audience_id is resolved from the stored mapping, never the body.

segment_id
string
required
Required string length: 1 - 200
members
object[]
required
Required array length: 1 - 10000 elements
operation
enum<string>
default:add

add activates members; remove is suppression.

Available options:
add,
remove

Response

The recorded activation run

data
object

A recorded ad-audience activation run (counts only — never the members / digests).

meta
object