Skip to content

tiktok_create_pixel_event

Add one standard event to a pixel of this advertiser, so a CONVERT or VALUE ad group can optimise for it (optimization_event).

View as Markdown

Add one standard event to a pixel of this advertiser, so a CONVERT or VALUE ad group can optimise for it (optimization_event). Developer mode: no rule is created, the website code sends the event. Sends no event and installs no code. TikTok lists new pixel events 2 to 4 hours later. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

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

Parameters

Parameters
NameTypeRequiredNotes
advertiserIdstringRequiredExact TikTok numeric ID as a string, never a rounded JavaScript number.
pixelIdstringRequiredpixel_id of a pixel owned by this advertiser (tiktok_get_pixels), not the pixel_code.
eventTypestringRequiredStandard event, as the optimization_event the ad group will use, for example ON_WEB_REGISTER (CompleteRegistration), FORM (Lead) or SHOPPING (Purchase).
eventNamestringOptionalEvent name shown in Events Manager, 40 characters at most.
statisticTypestringOptionalCount every conversion, or once per user. TikTok default: EVERY_TIME. One of: EVERY_TIME, ONCE.
confirmbooleanOptionalApply 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_pixel_event",
    "args": {
      "advertiserId": "<string>",
      "pixelId": "<string>",
      "eventType": "<string>"
    }
  }
}

Manage your ads from your AI assistant

Start for free

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

Esc

Type to search