View as Markdown
TikTok Ads Manager icon

TikTok Ads Manager ACTION

Send Conversion Event

Send a server-side web conversion event to TikTok via the Events API. Use this to report purchases, sign-ups, and other conversions without relying on browser-side tracking. pixel_id is the TikTok Pixel ID found in Events Manager — not the same as advertiser_id. Standard event names: Purchase, CompleteRegistration, ViewContent, AddToCart, InitiateCheckout, Subscribe, Contact, Download. User identifiers (email, phone_number, external_id) must be SHA256-hashed before passing. timestamp uses ISO 8601 format (e.g., 2024-01-15T19:49:27Z). Defaults to current time if omitted. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's TikTok Ads Manager account once, then configure and run Send Conversion Event from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "tiktok_ads_manager-send-conversion-event",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    tiktok_ads_manager: { authProvisionId: "apn_xxxxxxx" },
    pixelId: "Pixel ID",
    event: "Event Name",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Send Conversion Event inputs
Property Type Description
pixelId Pixel ID string
Your TikTok Pixel ID (pixel_code). Find it in TikTok Events Manager under Assets → Events → Website Pixel. This is different from your advertiser ID.
Required
event Event Name string
Conversion event name. Standard values: Purchase, CompleteRegistration, ViewContent, AddToCart, InitiateCheckout, Subscribe, Contact, Download. Custom event names are also accepted.
Required
eventId Event ID string
Unique identifier for this event to prevent duplicates. Format: {UniqueID}_RandomNumber e.g. OrderID_357 or SessionID_892. If omitted, deduplication is not applied.
Optional
timestamp Timestamp string
Time the event occurred in ISO 8601 format. Example: 2024-01-15T19:49:27Z. Defaults to current time if omitted.
Optional
value Order Value string
Total monetary value of the conversion (total order, not per-item). Required for Purchase events. Example: 99.99.
Optional
currency Currency string
ISO 4217 currency code. Required when value is set. Example: USD, EUR, GBP.
Optional
email Hashed Email string
SHA256-hashed email address (lowercase before hashing). Do NOT pass plaintext.
Optional
phoneNumber Hashed Phone Number string
SHA256-hashed phone number. Include country code with + (e.g., +12025551234) before hashing. Do NOT pass plaintext.
Optional
externalId External ID string
SHA256-hashed unique identifier from your system (e.g., loyalty ID, user ID). Helps match events to TikTok users.
Optional
pageUrl Page URL string
URL of the page where the event occurred. Example: https://example.com/checkout/confirmation.
Optional
ipAddress IP Address string
Non-hashed public IP address of the user's browser (IPv4 or IPv6). Sending this alongside user_agent increases match rates.
Optional
userAgent User Agent string
Non-hashed user agent string from the user's browser. Sending this alongside ip_address increases match rates.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
tiktok_ads_manager-send-conversion-event
Version
0.0.2
App
TikTok Ads Manager
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes