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

# Linking Reddit Ads as a source

Canonical URL: https://posthog.com/docs/data-pipelines/sources/reddit-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 Reddit 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://ads-api.reddit.com/docs/v3/operations/List%20Ad%20Groups)
-   [Campaigns](https://ads-api.reddit.com/docs/v3/operations/List%20Campaigns)
-   [Ads](https://ads-api.reddit.com/docs/v3/operations/List%20Ads)
-   [Ad Groups Report](https://ads-api.reddit.com/docs/v3/operations/Get%20A%20Report): Report broken down by `AD_GROUP_ID`
-   [Campaign Report](https://ads-api.reddit.com/docs/v3/operations/Get%20A%20Report): Report broken down by `CAMPAIGN_ID`
-   [Ad Report](https://ads-api.reddit.com/docs/v3/operations/Get%20A%20Report): Report broken down by `AD_ID`

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 Reddit Ads account with permission to access data from accounts you want to sync.
-   Your account ID (optional, but useful for reference). You can find it in the [business manager app](https://ads.reddit.com/business/) > Menu > Assets > Ad Accounts > get the ID

![Reddit account ID](https://res.cloudinary.com/dmukukwp6/image/upload/Screenshot_2025_09_11_at_7_01_43_PM_c31b74db4c.png)

## Configuring PostHog

Connect PostHog to your Reddit Ads account using a Reddit account. The Reddit 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 Reddit Ads in the sources list and click **Link**.
4.  Connect your Reddit account by selecting an existing integration or creating a new one.
5.  Select your ad account from the dropdown. Accounts are grouped by the business that owns them.
6.  (Optional) Add a prefix for the table name.

## Configuration

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

## Supported tables

| Table | Description | Sync method | Incremental field | Primary key |
| --- | --- | --- | --- | --- |
| `campaigns` | A Reddit Ads campaign grouping ad groups under a shared objective and budget. | Incremental, Full refresh | modified\_at | — |
| `ad_groups` | A Reddit Ads ad group within a campaign, defining targeting, bidding, and budget. | Incremental, Full refresh | modified\_at | — |
| `ads` | A Reddit Ads ad — the creative shown to users within an ad group. | Incremental, Full refresh | modified\_at | — |
| `campaign_report` | Daily aggregated performance metrics broken down by campaign. | Incremental, Full refresh | date | — |
| `ad_group_report` | Daily aggregated performance metrics broken down by ad group. | Incremental, Full refresh | date | — |
| `ad_report` | Daily aggregated performance metrics broken down by ad. | Incremental, Full refresh | date | — |
| `ad_account` | The connected Reddit Ads account, including the currency and time zone every spend figure is reported in. | Full refresh | — | — |
| `custom_audiences` | An audience built from advertiser-supplied data: a customer list, website or app retargeting via a Pixel, engagement retargeting, or a lookalike. | Full refresh | — | — |
| `saved_audiences` | A reusable targeting definition that ad groups can point at instead of redefining targeting each time. | Full refresh | — | — |
| `pixels` | A Reddit Pixel, the conversion tracker that reports website events back to Reddit Ads. | Full refresh | — | — |
| `funding_instruments` | A payment source campaigns bill against, carrying the currency spend is denominated in. | Full refresh | — | — |
| `lead_gen_forms` | A lead generation form users fill in from an ad, defining the questions asked and the privacy policy shown. | Full refresh | — | — |
| `profiles` | A Reddit profile the ad account can publish ads from. Ad and post rows reference it by ID. | Full refresh | — | — |
| `structured_posts` | The post backing an ad's creative, carrying the headline, media, and destination the ad actually showed. Join to ads on `post_id` to attribute performance to a creative. | Full refresh | — | — |
| `campaign_country_report` | Daily campaign performance metrics broken down by the country the impression was served in. | Incremental, Full refresh | date | — |
| `campaign_gender_report` | Daily campaign performance metrics broken down by the viewer's gender. | Incremental, Full refresh | date | — |
| `campaign_placement_report` | Daily campaign performance metrics broken down by where on Reddit the creative was placed. | Incremental, Full refresh | date | — |
| `campaign_community_report` | Daily campaign performance metrics broken down by the community (subreddit) the ad ran in. | Incremental, Full refresh | date | — |
| `campaign_os_type_report` | Daily campaign performance metrics broken down by the viewer's device operating system. | Incremental, Full refresh | date | — |
| `campaign_keyword_report` | Daily campaign performance metrics broken down by the keyword the ad was matched on. | Incremental, Full refresh | date | — |