external-platform

Launch Tiktok Video Ad

Start a TikTok launch job and return tracking info.

post/api/external-platform/tiktok/launch-video-ad

Request

  • Base URL: https://api.usepomo.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.usepomo.ai/api/external-platform/tiktok/launch-video-ad
  • Auth: HTTP bearer

Request body

ad_idstring required
advertiser_idstring nullable
audience_group_idstring nullable

CRM audience to retarget or suppress

audience_modestring nullable

How to apply the CRM audience: include or exclude

ad_text_overridestring nullable

Optional override for ad_text (TikTok requirement: max 100 chars)

display_name_overridestring nullable

Optional override for display_name (TikTok requirement: max 40 chars)

ad_name_overridestring nullable

Optional override for ad_name (TikTok requirement: max 512 chars)

Response

Successful Response

job_idstring required

Unique job identifier

statusstring required

Initial job status (typically 'running')

stream_urlstring required

SSE endpoint for real-time progress

poll_urlstring required

HTTP endpoint for polling status

Example response

{
  "job_id": "987fcdeb-51a2-43f7-9876-543210987654",
  "poll_url": "/api/chat/agentic/jobs/987fcdeb-51a2-43f7-9876-543210987654",
  "status": "running",
  "stream_url": "/api/chat/agentic/jobs/987fcdeb-51a2-43f7-9876-543210987654/stream"
}

Changes

No recorded changes to this operation across all 1 revision of this API.