tiktok_create_audience_from_file

Create a TikTok customer file audience in this advertiser from the file_path values of tiktok_upload_audience_file.

Create a TikTok customer file audience in this advertiser from the file_path values of tiktok_upload_audience_file. TikTok matches it within 48 hours; an ad group can use it once it is valid and large enough. Include it with audience_ids or exclude it with excluded_audience_ids on an ad group. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Source: TikTok Ads
Kind: Write
Discovery: Reachable through search_tools and run_tool
Account parameter: advertiserId
Endpoint: https://mcp.getmcpads.com/tiktok-ads/mcp

Parameters

Parameters
Name	Type	Required	Notes
`advertiserId`	string	Required	Exact TikTok numeric ID as a string, never a rounded JavaScript number.
`name`	string	Required	Exact audience name, 128 characters at most.
`filePaths`	array	Required	file_path values returned by tiktok_upload_audience_file for this same advertiser.
`calculateType`	string	Required	The calculateType returned with these files; every file must share it. One of: `EMAIL_SHA256`, `PHONE_SHA256`, `MULTIPLE_TYPES`.
`retentionInDays`	integer	Optional	Fixed lifetime in days from creation, 1 to 365. Omitted: TikTok keeps the audience 365 days after its last use or change.
`confirm`	boolean	Optional	Apply only when true. Default is a local preview without any TikTok call. Never retry an uncertain POST automatically.

Calling it

json · Through run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "tiktok_create_audience_from_file",
    "args": {
      "advertiserId": "<string>",
      "name": "<string>",
      "filePaths": "<array>",
      "calculateType": "EMAIL_SHA256"
    }
  }
}

Manage your ads from your AI assistant

Start for free

Free with 1 ad account, no card. Pro is free for 7 days.