> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.pivolio.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.pivolio.com/_mcp/server.

# Reddit

Pivolio delivers to Reddit Conversions API v3 at
`POST https://ads-api.reddit.com/api/v3/pixels/{pixel_id}/conversion_events`.

> **Warning**
>
> Reddit **rejects events older than 7 days** — it is the only destination with an
> age cap. Anything that sits longer than that in a retry loop, an outage, or a
> paused integration will never be accepted, no matter how many times it is
> retried. If you reconnect a destination after a long gap, treat the backlog
> older than a week as lost.

## Get your credentials

Directional steps — Reddit's ads interface moves things around, so follow the
concepts.

#### Find your pixel ID

In **Reddit Ads**, open the events or pixel section and select your pixel.
Reddit pixel IDs start with `a2_` — if the value you copied doesn't, you
have the wrong identifier.

#### Create an access token

Generate a Conversions API access token with permission to write
conversion events for that pixel. Copy it at creation time.

#### Connect in Pivolio

Open **Destinations → Reddit**, paste the pixel ID and token, and verify.
There is no test event code to supply — see below.

## Credential fields

#### pixel_id

The Reddit pixel conversions are posted to. Required, and validated to
**start with `a2_`** — Pivolio rejects anything else at save time rather
than letting you discover the mistake through silent 404s.

#### access_token

The Conversions API token. Required, stored encrypted, never returned.
Rotate by pasting a new value over the old one.

> **Note**
>
> Reddit has **no test event code**. Unlike Meta and TikTok, there is no way to
> route a verification event into a separate test view — verification talks to
> the live pixel. Expect the verification event to appear in your normal Reddit
> reporting.

## Event mapping

| Pivolio event                      | Reddit tracking type |
| ---------------------------------- | -------------------- |
| `page_view`                        | PageVisit            |
| `view_content`                     | ViewContent          |
| `search`                           | Search               |
| `add_to_cart`                      | AddToCart            |
| `add_to_wishlist`                  | AddToWishlist        |
| `order_completed`, `purchase`      | Purchase             |
| `lead_submitted`, `lead`           | Lead                 |
| `sign_up`, `complete_registration` | SignUp               |

An event whose name is not in this table is **skipped**, exactly as it is on
Meta and TikTok — `download` and `schedule`, for instance, are never sent to
Reddit by default.

Reddit does support a `CUSTOM` tracking type, but it only comes into play when
you [configure a mapping](/documentation/destinations/event-mappings) explicitly. Point a mapping at a
name Reddit doesn't recognize and the event is delivered as `CUSTOM`, carrying
that name. Without a mapping, nothing is sent.

## Timestamps

Reddit expects **millisecond** timestamps, while Meta, Google and TikTok use
seconds. Pivolio handles the conversion; you never send times in a different
unit depending on destination. It matters only if you are reconciling raw
payloads by hand and wonder why the numbers are a thousand times larger.

## Related

* [Event mappings](/documentation/destinations/event-mappings) — including how custom names are handled.
* [Consent rules](/documentation/destinations/consent-rules)
* [Troubleshooting](/documentation/destinations/troubleshooting-delivery)