> ## Documentation Index
> Fetch the complete documentation index at: https://www.edgee.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Pinterest Conversions API

> Send your conversion events directly to Pinterest's Conversions API (CAPI), **now at the edge**.

<img src="https://mintcdn.com/edgee/enlt_qUyIUJ64Dg-/images/banners/pinterest-capi.png?fit=max&auto=format&n=enlt_qUyIUJ64Dg-&q=85&s=05f4f45c7ed6ff2830de698e6c94cfc4" className="rounded-lg" noZoom width="1312" height="334" data-path="images/banners/pinterest-capi.png" />

Find it on GitHub: [<Icon icon="github" iconType="solid" /> /edgee-ai/pinterest-capi-component](https://github.com/edgee-ai/pinterest-capi-component)

Pinterest Conversions API (CAPI) allows you to send web events directly to Pinterest from your server, ensuring reliable data tracking even with ad blockers or browser limitations. With Edgee's edge integration, you can now send these events directly from the edge, improving both reliability and performance.

## Event Mapping

Here's how Edgee events map to Pinterest CAPI events:

| Edgee event | Pinterest CAPI Event |
| ----------- | -------------------- |
| Page        | `page_visit`         |
| Track       | `custom`             |
| User        | `lead`               |

<Warning>
  Pinterest Conversions API requires user identification data for event processing. Each event must include at least one of the following user properties:

  * Email

  Events without any user identification will be ignored by Pinterest.
</Warning>

## User Identification

When you make a `user` call, Edgee stores the user's data (user\_id, anonymous\_id, and properties) on the device. This enables proper attribution for subsequent page views and events.

## Getting Started

**To integrate Pinterest CAPI into your Edgee project:**

1. Open the Edgee console and navigate to your project's Components.
2. Select "Add a component" and choose `edgee/pinterest-capi` from the list of available components.
3. Enter the following credentials:
   * `Pinterest Access Token`: Your Pinterest CAPI access token
   * `Pinterest Ad Account ID`: Your Pinterest Ad Account ID
   * `Pinterest is Test` (Optional): For testing your implementation
4. Click Save to complete the setup.

To know how to get your access token and ad Account Id visit the [Pinterest API documentation](https://help.pinterest.com/en/business/article/the-pinterest-api-for-conversions).

## Destination name

When configuring the destination in your **Edgee Data Layer** or within SDK calls, use `pinterest_capi` as the component name:

```json theme={"dark"}
{
  "components": {
    "edgee/pinterest-capi": true
  }
}
```

## Testing Your Implementation

1. Set your `is_test` flag to `true` in the component configuration
2. Send test events through Edgee
3. Verify events in Pinterest Conversion Tab within ads manager

<Note>
  Use Pinterest test property `is_test` to test your implementation without affecting your production data.
</Note>

For more details on Pinterest Conversions API implementation, refer to the
[official Pinterest CAPI documentation](https://help.pinterest.com/en/business/article/the-pinterest-api-for-conversions).