View as Markdown
TikTok Ads Manager icon

TikTok Ads Manager ACTION

Create or Update Ad

Create a new TikTok ad or update an existing one. Omit ad_id to create; provide it to update. Creative assets must be uploaded first using Upload Creative — the API requires asset IDs, not file URLs. identity_type and identity_id are required in v1.3; use CUSTOMIZED_USER for non-Spark Ads. For create, see documentation. For update, see documentation.
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's TikTok Ads Manager account once, then configure and run Create or Update Ad 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-create-or-update-ad",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    tiktok_ads_manager: { authProvisionId: "apn_xxxxxxx" },
    advertiserId: "Advertiser ID",
    adId: "Ad ID",
  },
})

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.

Create or Update Ad inputs
Property Type Description
advertiserId Advertiser ID string
Your TikTok Ads Manager advertiser ID. Find it in the Ads Manager URL after aadvid= (e.g., aadvid=7123456789012345678). Also visible under Account Info in Business Center.
Required
adId Ad ID string
ID of an existing ad to update. Omit to create a new ad. Use List Ads to find existing IDs.
Optional
adgroupId Ad Group ID string
Ad group to place this ad in. Required for create and update. Use List Ad Groups to find IDs.
Required
adName Ad Name string
Internal name for the ad. Maximum 512 characters.
Required
identityType Identity Type string
Required in v1.3. Use CUSTOMIZED_USER for standard (non-Spark) ads. AUTH_CODE or BC_AUTH_TT for Spark Ads. See TikTok Identities documentation for details.
Optional
identityId Identity ID string
Required in v1.3. The ID of the identity corresponding to identity_type.
Optional
adFormat Ad Format string
SINGLE_VIDEO requires video_id. SINGLE_IMAGE requires image_ids. CAROUSEL_ADS for standard carousel.
Optional
imageIds Image IDs string[]
Asset IDs of uploaded images from Upload Creative. Required for SINGLE_IMAGE. Also used as video cover/thumbnail for SINGLE_VIDEO (one ID only).
Optional
videoId Video ID string
Asset ID of an uploaded video from Upload Creative. Required for SINGLE_VIDEO when identity_type is CUSTOMIZED_USER.
Optional
adText Ad Text string
Main ad copy shown to the audience. Maximum 100 characters, no emoji.
Optional
callToAction Call to Action string
CTA button label. Example values: LEARN_MORE, SHOP_NOW, SIGN_UP, DOWNLOAD_NOW, CONTACT_US, APPLY_NOW, BOOK_NOW.
Optional
landingPageUrl Landing Page URL string
URL users are redirected to when they click the ad.
Optional
displayName Display Name string
Brand or business name shown on the ad. Required when promotion type is landing page or pure exposure. 1-40 English characters.
Optional
operationStatus Status string
Operational status. ENABLE = active, DISABLE = paused.
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-create-or-update-ad
Version
0.0.2
App
TikTok Ads Manager
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes