How to Integrate TikTok Ads with Your Headless CMS

What is TikTok Ads?

TikTok Ads is TikTok's advertising platform for running paid campaigns across TikTok and its partner placements. Marketing teams use it to build campaigns, ad groups, creative ads, product catalog promotions, Spark Ads, and conversion-focused campaigns through TikTok Ads Manager and the TikTok Business API. Its core capability is turning video-first creative, audience targeting, bidding, and measurement into paid distribution on one of the largest short-form video platforms.

Why integrate TikTok Ads with a headless CMS?

TikTok campaigns move fast. A retail team might run 40 product drops in a month, each with a launch date, offer copy, landing page URL, product imagery, creator video ID, UTM rules, and legal disclaimers. If that data lives in spreadsheets, chat threads, and page fields, someone has to copy it into TikTok Ads Manager by hand. That creates predictable problems: wrong promo codes, stale landing pages, missed launch windows, and ads that don't match the page users land on.

Connecting TikTok Ads to a headless CMS gives your paid social team a cleaner path from approved content to live campaigns. With structured content, you can model campaign fields once, validate them in the editorial workflow, and send only the fields TikTok Ads needs. In Sanity, that content lives as typed JSON in the Content Lake, so a sync job doesn't have to scrape HTML or parse page blobs to find the offer headline, CTA, product SKU, or destination URL.

Real-time webhooks make the workflow practical. When a marketer publishes a TikTok campaign brief in Sanity Studio, a webhook or Function can call the TikTok Business API right away. The trade-off is that TikTok still has its own review process, rate limits, OAuth tokens, and media upload requirements. The integration doesn't remove those constraints, but it does remove the copy-and-paste layer between approved content and ad creation.

Architecture overview

A typical integration starts with campaign, product, offer, and landing page content modeled in Sanity Studio. When a document is published, a Sanity webhook fires with the document ID and type. A Sanity Function or webhook listener receives that event, uses GROQ to fetch the exact fields TikTok Ads needs, and then calls the TikTok Business API with an access token tied to your advertiser account. For example, the Function can query a published TikTok campaign document, join the referenced product and landing page, and build a payload with advertiser_id, adgroup_id, ad_name, ad_text, call_to_action, landing_page_url, and an existing TikTok video_id. It can then POST to https://business-api.tiktok.com/open_api/v1.3/ad/create/ with the Access-Token header. TikTok processes the ad, applies review rules, and serves the approved creative to users in the TikTok app or eligible placements. Sanity handles the content event and field selection. TikTok Ads handles campaign delivery, bidding, review, and reporting. If you also sync status or review results back into Sanity, editors can see whether a campaign document produced a draft ad, an approved ad, or an API error without leaving Sanity Studio.

Common use cases

Step-by-step integration

1. 1

   Set up TikTok Ads access

   Create or use an existing TikTok Ads Manager account, confirm the advertiser_id, create a TikTok for Business developer app, request Marketing API access, and complete OAuth to get an access token. Install your HTTP client or TikTok Business API SDK in the service that will receive Sanity events.

2. 2

   Model TikTok campaign content in Sanity Studio

   Create schema fields for campaignName, advertiserId, adgroupId, adText, callToAction, landingPageUrl, videoId, market, startDate, endDate, UTM values, and reviewStatus. Use validations for TikTok limits, such as required landing page URLs and approved CTA values.

3. 3

   Create a publish trigger

   Add a Sanity webhook filtered to the TikTok campaign document type, or use a Sanity Function triggered by content mutations. Configure it to run on publish events, not every draft edit, so TikTok only receives approved content.

4. 4

   Fetch the final payload with GROQ

   In the handler, use @sanity/client and GROQ to fetch the published campaign plus referenced product, offer, and landing page fields. Project the result into the exact shape your TikTok request needs.

5. 5

   Call the TikTok Business API

   POST to the TikTok ad creation or update endpoint, such as /open_api/v1.3/ad/create/, with advertiser_id, adgroup_id, creatives, ad_text, call_to_action, landing_page_url, and video_id. Store the returned ad_id or error message back on the Sanity document if your workflow needs status tracking.

6. 6

   Test the full user path

   Publish a test campaign, confirm the API request in your logs, check the ad in TikTok Ads Manager, verify review status, and click through to the landing page. Test token expiration, missing video IDs, rejected copy, and unpublished landing pages before giving the workflow to marketers.

Code example

import {createClient} from '@sanity/client';
import type {VercelRequest, VercelResponse} from '@vercel/node';

const sanity = createClient({
  projectId: process.env.SANITY_PROJECT_ID!,
  dataset: process.env.SANITY_DATASET!,
  apiVersion: '2025-01-01',
  token: process.env.SANITY_READ_TOKEN!,
  useCdn: false,
});

export default async function handler(req: VercelRequest, res: VercelResponse) {
  const {documentId} = req.body;

  const ad = await sanity.fetch(`*[_id == $id][0]{
    campaignName,
    advertiserId,
    adgroupId,
    adText,
    callToAction,
    landingPageUrl,
    videoId
  }`, {id: documentId.replace('drafts.', '')});

  const tikTokRes = await fetch('https://business-api.tiktok.com/open_api/v1.3/ad/create/', {
    method: 'POST',
    headers: {
      'Access-Token': process.env.TIKTOK_ACCESS_TOKEN!,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      advertiser_id: ad.advertiserId,
      adgroup_id: ad.adgroupId,
      creatives: [{
        ad_name: ad.campaignName,
        ad_format: 'SINGLE_VIDEO',
        video_id: ad.videoId,
        ad_text: ad.adText,
        call_to_action: ad.callToAction,
        landing_page_url: ad.landingPageUrl,
      }],
    }),
  });

  const result = await tikTokRes.json();
  if (!tikTokRes.ok || result.code !== 0) return res.status(500).json(result);

  return res.status(200).json({tiktokAdId: result.data.ad_ids?.[0]});
}

How Sanity + TikTok Ads works

CMS approaches to TikTok Ads

Keep building

Explore related integrations to complete your content stack.