# TikTok Ads Manager — Pipedream Connect

> Everything you need to create, launch, and optimize TikTok campaigns—all in one place.

- API slug: `tiktok_ads_manager` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: Marketing
- Website: https://ads.tiktok.com/business/en/solutions/ads-manager
- This page (HTML): https://pipedream.com/apps/tiktok-ads-manager
- Tools: 15 actions · 0 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: tiktok_ads_manager`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
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 accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "tiktok_ads_manager",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Create Audience:
const result = await mcp.callTool({
  name: "tiktok_ads_manager-create-audience",
  arguments: {
    advertiserId: "Advertiser ID",
    audienceName: "Audience Name",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a TikTok Ads Manager endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://business-api.tiktok.com/open_api/v1.3/user/info/

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9idXNpbmVzcy1hcGkudGlrdG9rLmNvbS9vcGVuX2FwaS92MS4zL3VzZXIvaW5mby8?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
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-audience",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    tiktok_ads_manager: { authProvisionId: "apn_xxxxxxx" },
    advertiserId: "Advertiser ID",
    audienceName: "Audience Name",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (15)

### `tiktok_ads_manager-create-audience` — Create Audience (Write)

Create a new TikTok custom audience from hashed customer identifiers. Uploads the identifiers first, then creates the audience — both steps happen in one tool call. Provide either identifiers (a list of SHA256-hashed values passed directly) or file_path (a CSV file with one identifier per line)…

Full schema: https://pipedream.com/apps/tiktok-ads-manager/actions/create-audience.md

### `tiktok_ads_manager-create-lookalike-audience` — Create Lookalike Audience (Write)

Create a TikTok lookalike audience based on an existing custom audience. TikTok finds users who share characteristics with the source audience. Use List Audiences to find the source audience ID. audience_size controls reach vs accuracy: NARROW = most similar (smallest), BALANCED = mixed, BROAD =…

Full schema: https://pipedream.com/apps/tiktok-ads-manager/actions/create-lookalike-audience.md

### `tiktok_ads_manager-create-or-update-ad` — Create or Update Ad (Write)

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…

Full schema: https://pipedream.com/apps/tiktok-ads-manager/actions/create-or-update-ad.md

### `tiktok_ads_manager-create-or-update-ad-group` — Create or Update Ad Group (Write)

Create a new TikTok ad group or update an existing one. Omit adgroup_id to create; provide it to update. Ad groups control placement, targeting, budget, schedule, bidding, and optimization within a campaign. billing_event must correspond to the chosen optimization_goal — e.g., CLICK → CPC…

Full schema: https://pipedream.com/apps/tiktok-ads-manager/actions/create-or-update-ad-group.md

### `tiktok_ads_manager-create-or-update-campaign` — Create or Update Campaign (Write)

Create a new TikTok campaign or update an existing one. Omit campaign_id to create; provide it to update. objective_type, budget_mode, and budget are required when creating but are not accepted by the update endpoint. Common objective types: REACH, TRAFFIC, VIDEO_VIEWS, LEAD_GENERATION…

Full schema: https://pipedream.com/apps/tiktok-ads-manager/actions/create-or-update-campaign.md

### `tiktok_ads_manager-get-advertiser-info` — Get Advertiser Info (Read-only)

Identity tool — call this first when a user references 'my account' or 'my campaigns'. Returns account details (name, currency, timezone, status) for the given advertiser ID. Find your advertiser ID in the TikTok Ads Manager URL after aadvid=. See the documentation.

Full schema: https://pipedream.com/apps/tiktok-ads-manager/actions/get-advertiser-info.md

### `tiktok_ads_manager-get-report` — Get Report (Read-only)

Run a synchronous report to retrieve performance metrics for campaigns, ad groups, or ads. report_type is required. advertiser_id is required for BASIC, AUDIENCE, PLAYABLE_MATERIAL, CATALOG, and TT_SHOP reports; use bc_id for BC reports. data_level is required for BASIC, AUDIENCE, and CATALOG…

Full schema: https://pipedream.com/apps/tiktok-ads-manager/actions/get-report.md

### `tiktok_ads_manager-manage-spark-ad` — Get Spark Ad Video Info (Read-only)

Get information about one or more TikTok posts published via a linked identity, for use as Spark Ad creatives. Returns video duration, dimensions, cover image, authorization status, and visibility. Requires an identity (identity_type + identity_id) — use /identity/get/ to find identities linked to…

Full schema: https://pipedream.com/apps/tiktok-ads-manager/actions/manage-spark-ad.md

### `tiktok_ads_manager-list-ad-groups` — List Ad Groups (Read-only)

List ad groups in a TikTok Ads account with optional filters. Returns ad group IDs, names, status, budget, schedule, and targeting. Use campaign IDs from List Campaigns to filter. Use ad group IDs returned here as input to List Ads or Create or Update Ad. See the documentation

Full schema: https://pipedream.com/apps/tiktok-ads-manager/actions/list-ad-groups.md

### `tiktok_ads_manager-list-ads` — List Ads (Read-only)

List ads in a TikTok Ads account with optional filters. Returns ad IDs, names, status, and creative details. Use campaign or ad group IDs from List Campaigns / List Ad Groups to narrow results. See the documentation

Full schema: https://pipedream.com/apps/tiktok-ads-manager/actions/list-ads.md

### `tiktok_ads_manager-list-audiences` — List Audiences (Read-only)

List custom audiences in a TikTok Ads account. Returns audience IDs, names, types, coverage, validity, and expiry. Returns both owned and shared audiences — use is_creator in the response to check ownership. Use audience IDs returned here as input to Update Audience or Create Lookalike Audience…

Full schema: https://pipedream.com/apps/tiktok-ads-manager/actions/list-audiences.md

### `tiktok_ads_manager-list-campaigns` — List Campaigns (Read-only)

List campaigns in a TikTok Ads account with optional filters. Returns campaign IDs, names, status, objective, and budget. Use campaign IDs returned here as input to List Ad Groups or Get Report. See the documentation

Full schema: https://pipedream.com/apps/tiktok-ads-manager/actions/list-campaigns.md

### `tiktok_ads_manager-send-conversion-event` — Send Conversion Event (Write)

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…

Full schema: https://pipedream.com/apps/tiktok-ads-manager/actions/send-conversion-event.md

### `tiktok_ads_manager-update-audience` — Update Audience (Write)

Update a TikTok custom audience — rename it, or add/remove/replace members via a file of hashed identifiers. To rename only, provide audience_name and omit identifiers/file_path. To modify members, provide identifiers or file_path and set action (APPEND, REMOVE, or REPLACE). The file upload and…

Full schema: https://pipedream.com/apps/tiktok-ads-manager/actions/update-audience.md

### `tiktok_ads_manager-upload-creative` — Upload Creative (Write)

Upload an image or video to the TikTok Ads Asset Library and return its asset ID. Always run this tool before Create or Update Ad when using new creative — the ad creation API requires asset IDs, not file URLs. Provide a publicly accessible URL or a /tmp file path. Returns image_id for images and…

Full schema: https://pipedream.com/apps/tiktok-ads-manager/actions/upload-creative.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt