TOOL API

audience_segment_operate

Creates or deletes an audience segment through the Streaming API endpoint `/open_api/v1.3/segment/audience/`. Access is allowlist-only: to apply for Streaming API access (formerly Segment API), use the Allowlist Management feature in the Developer Portal and select "Streaming API". Rate limit is 1 QPS per advertiser account. You can have up to 400 audience segments per advertiser account; if this advertiser-level limit is reached, delete existing audiences before creating new ones. Before using this endpoint, review the Streaming API important notes for Multiple Advertisers Associated with a Business Account and Mixed Segments with IDFA/AAID, and follow the identifier normalization guidance at https://business-api.tiktok.com/portal/docs?id=1850030360880129.

ecommerceOAuth1 credits

Call information

Tool slug
tiktok-ads.audience_segment_operate
Provider
TikTok for Business
Average response
0 ms
Calls in 7 days
0

Input parameters

actionrequired

Action to perform. `create` creates an audience segment and requires `custom_audience_name`. `delete` deletes an audience segment and requires `delete_audience_id`. If omitted, the default is `create`.

advertiser_idrequired

Advertiser ID.

custom_audience_name

Name of the audience segment to create. Required when `action` is `create`. Names longer than 70 characters are truncated to 67 characters and appended with `...`.

delete_audience_id

Audience ID of the segment to delete. Required when `action` is `delete`.