> AI agents: this is one page from PostHog's docs. Full index of Markdown docs for LLMs: https://posthog.com/llms.txt

# Linking TikTok Ads as a source

Canonical URL: https://posthog.com/docs/data-pipelines/sources/tiktok-ads

> **Cloud region:** This page uses US Cloud hosts. For an EU Cloud project, use `https://eu.posthog.com` instead of `https://app.posthog.com` (app host for links).

## On this page

- [Requirements](#requirements)
- [Configuring PostHog](#configuring-posthog)
- [Configuration](#configuration)
- [Supported tables](#supported-tables)
- [Troubleshooting](#troubleshooting)

![](https://res.cloudinary.com/dmukukwp6/image/upload/texture_tan_9608fcca70)

![](https://res.cloudinary.com/dmukukwp6/image/upload/texture_tan_dark_a92b0e022d)

Let AI connect your sources for you

Skip the manual setup — run this in your project and the wizard auto-detects your databases and APIs and connects them to PostHog.

`npx @posthog/wizard warehouse`

![PostHog Wizard hedgehog](https://res.cloudinary.com/dmukukwp6/image/upload/wizard_3f8bb7a240.png)

![](https://res.cloudinary.com/dmukukwp6/image/upload/wizard_3f8bb7a240.png)Let AI connect your sources for you

You can sync data from TikTok Ads reports by configuring it as a source in PostHog. The supported reports that can be synced include Ad Groups, Campaigns, Ads, Ad Group Report, Campaign Report, and Ad Report, as described here:

-   [Ad Groups](https://business-api.tiktok.com/portal/docs?id=1739314558673922)
-   [Campaigns](https://business-api.tiktok.com/portal/docs?id=1739315828649986)
-   [Ads](https://business-api.tiktok.com/portal/docs?id=1735735588640770)
-   [Ad Groups Report](https://business-api.tiktok.com/portal/docs?id=1740302848100353): Filter by `adgroup_ids`
-   [Campaign Report](https://business-api.tiktok.com/portal/docs?id=1740302848100353): Filter by `campaign_ids`
-   [Ad Report](https://business-api.tiktok.com/portal/docs?id=1740302848100353): Filter by `ad_ids`

Additional reports will be added based on user feedback we receive via our [in-app support form](https://app.posthog.com/#panel=support%3Afeedback%3Adata_warehouse%3Alow%3Atrue).

## Requirements

-   A TikTok Ads account with permission to access data from accounts you want to sync.

## Configuring PostHog

Connect PostHog to your TikTok Ads account. The TikTok account must have permission to access data.

1.  In PostHog, go to the **[Data pipelines](https://app.posthog.com/data-management/sources)** tab.
2.  Open the **\+ New** drop-down menu in the top-right and select **Source**.
3.  Find TikTok Ads in the sources list and click **Link**.
4.  Select an existing TikTok Ads integration, or create a new one by clicking **Connect**.
5.  Select the advertiser account you want to sync from the dropdown.
6.  (Optional) Add a prefix for the table name.

## Configuration

| Option | Type | Required |
| --- | --- | --- |
| `TikTok Ads account` | oauth | Yes |
| `TikTok Ads Advertiser ID` | oauth-account-select | Yes |

## Supported tables

| Table | Description | Sync method | Incremental field | Primary key |
| --- | --- | --- | --- | --- |
| `advertiser_report` | Daily advertiser spend, including the amount charged to cash rather than vouchers. | Incremental, Full refresh | stat\_time\_day | — |
| `campaigns` | An advertising campaign in your TikTok Ads account, with its objective and budget. | Full refresh | — | — |
| `ad_groups` | An ad group within a campaign, defining targeting, placement, and bidding. | Full refresh | — | — |
| `ads` | An individual ad creative within an ad group. | Full refresh | — | — |
| `campaign_report` | Daily performance metrics for each campaign. | Incremental, Full refresh | stat\_time\_day | — |
| `ad_group_report` | Daily performance metrics for each ad group. | Incremental, Full refresh | stat\_time\_day | — |
| `ad_report` | Daily performance metrics for each ad. | Incremental, Full refresh | stat\_time\_day | — |
| `creative_videos` | A video asset in your TikTok Ads creative library, joinable to the video used by an ad. Requires creative asset read access on the authorized advertiser; without it TikTok refuses the request and this table can't sync. | Full refresh | — | — |
| `creative_images` | An image asset in your TikTok Ads creative library, joinable to the images used by an ad. Requires creative asset read access on the authorized advertiser; without it TikTok refuses the request and this table can't sync. | Full refresh | — | — |
| `campaign_demographic_report` | Daily campaign performance broken down by the viewer's gender and age bucket. | Incremental, Full refresh | stat\_time\_day | — |
| `campaign_country_report` | Daily campaign performance broken down by the viewer's country. | Incremental, Full refresh | stat\_time\_day | — |
| `campaign_platform_report` | Daily campaign performance broken down by the viewer's operating system. | Incremental, Full refresh | stat\_time\_day | — |
| `ad_group_demographic_report` | Daily ad group performance broken down by the viewer's gender and age bucket. | Incremental, Full refresh | stat\_time\_day | — |
| `ad_group_country_report` | Daily ad group performance broken down by the viewer's country. | Incremental, Full refresh | stat\_time\_day | — |
| `ad_group_platform_report` | Daily ad group performance broken down by the viewer's operating system. | Incremental, Full refresh | stat\_time\_day | — |
| `ad_demographic_report` | Daily ad performance broken down by the viewer's gender and age bucket. | Incremental, Full refresh | stat\_time\_day | — |
| `ad_country_report` | Daily ad performance broken down by the viewer's country. | Incremental, Full refresh | stat\_time\_day | — |
| `ad_platform_report` | Daily ad performance broken down by the viewer's operating system. | Incremental, Full refresh | stat\_time\_day | — |

## Troubleshooting

### Finding your account ID manually

If the advertiser account dropdown in step 5 doesn't load, you can find your account ID manually in TikTok Ads Manager:

1.  Go to the [TikTok Ads Manager dashboard](https://ads.tiktok.com/i18n/dashboard).
2.  Click your account name in the top right and open the dropdown.
3.  Find your ad account ID, or check the dashboard URL, e.g. `https://ads.tiktok.com/i18n/dashboard?aadvid=ID_HERE`

![TikTok account ID](https://res.cloudinary.com/dmukukwp6/image/upload/w_500,c_limit,q_auto,f_auto/Screenshot_2025_09_30_at_11_25_16_AM_ab70c4f7c4.png)