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

# Linking Pinterest Ads as a source

Canonical URL: https://posthog.com/docs/data-pipelines/sources/pinterest-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)

![](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 Pinterest Ads by configuring it as a source in PostHog. The supported entities and reports include campaigns, ad groups, ads, campaign analytics, ad group analytics, and ad analytics:

-   [Campaigns](https://developers.pinterest.com/docs/api/v5/campaigns-list/): Campaign entities from your Pinterest Ads account
-   [Ad Groups](https://developers.pinterest.com/docs/api/v5/ad_groups-list/): Ad group entities within campaigns
-   [Ads](https://developers.pinterest.com/docs/api/v5/ads-list/): Individual ad entities within ad groups
-   [Campaign Analytics](https://developers.pinterest.com/docs/api/v5/campaigns-analytics/): Performance metrics at the campaign level
-   [Ad Group Analytics](https://developers.pinterest.com/docs/api/v5/ad_groups-analytics/): Performance metrics at the ad group level
-   [Ad Analytics](https://developers.pinterest.com/docs/api/v5/ads-analytics/): Performance metrics at the ad level

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 Pinterest Ads account with permission to access data from the accounts you want to sync.

> **Tip:** If you need to find your Ad Account ID manually, go to [Pinterest Business](https://business.pinterest.com/) > Ads > select your account. The ID is in the URL or account settings.

## Configuring PostHog

Connect PostHog to your Pinterest Ads account using a Pinterest account. The Pinterest account must have permission to access the ad account 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 Pinterest Ads in the sources list and click **Link**.
4.  Connect your Pinterest account by selecting an existing integration or creating a new one.
5.  Select the **Ad Account** you want to sync from the dropdown. Each account displays your permission level (Owner, Campaign Manager, etc.).
6.  (Optional) Add a prefix for the table name.

## Configuration

| Option | Type | Required |
| --- | --- | --- |
| `Pinterest Ads account` | oauth | Yes |
| `Pinterest Ads Ad Account ID` | oauth-account-select | Yes |

## Supported tables

| Table | Description | Sync method | Incremental field | Primary key |
| --- | --- | --- | --- | --- |
| `campaigns` | A Pinterest advertising campaign that groups ad groups under a single objective and budget. | Full refresh | — | — |
| `ad_groups` | A group of ads within a campaign, sharing targeting, budget, and bidding settings. | Full refresh | — | — |
| `ads` | An individual ad (promoted Pin) belonging to an ad group. | Full refresh | — | — |
| `ad_accounts` | The configured Pinterest ad account, including the currency and time zone every spend figure is reported in. | Full refresh | — | — |
| `audiences` | Targetable audiences owned by the ad account, such as customer lists, engagement audiences, and actalike audiences. | Full refresh | — | — |
| `conversion_tags` | Pinterest tags (pixels) installed for the ad account, which report the conversion events that campaigns optimize against. | Full refresh | — | — |
| `keywords` | Keyword targets defined on the ad account's campaigns and ad groups, used to resolve keyword targeting back to the term that was bid on. | Full refresh | — | — |
| `campaign_analytics` | Daily performance metrics (spend, impressions, clicks, conversions) per campaign. | Incremental, Full refresh | date | — |
| `ad_group_analytics` | Daily performance metrics (spend, impressions, clicks, conversions) per ad group. | Incremental, Full refresh | date | — |
| `ad_analytics` | Daily performance metrics (spend, impressions, clicks, conversions) per ad. | Incremental, Full refresh | date | — |
| `campaign_targeting_analytics` | Daily campaign performance broken down by targeting dimension (age, gender, device, placement, country, region). | Incremental, Full refresh | date | — |
| `ad_group_targeting_analytics` | Daily ad group performance broken down by targeting dimension (age, gender, device, placement, country, region). | Incremental, Full refresh | date | — |
| `ad_targeting_analytics` | Daily ad performance broken down by targeting dimension (age, gender, device, placement, country, region). | Incremental, Full refresh | date | — |