# Pinterest Ads Quick Start Guide

## Destination Info

* Supports [Track](https://documentation.freshpaint.io/developer/freshpaint-sdk-reference#track) calls
* Supports [HIPAA mode](https://documentation.freshpaint.io/hipaa-mode)
* Supports forwarding from the [Google Tag Manager Integration](/integrations/google-tag-manager-integration.md)
* Refer to this destination as **pinterest-ads** in the [Integrations object](https://documentation.freshpaint.io/reference/developer/freshpaint-sdk-reference#using-the-integrations-object)
* Connection Modes:

<table><thead><tr><th width="200.33333333333331" align="right"> </th><th data-type="checkbox">Client-side</th><th data-type="checkbox">Server-side</th></tr></thead><tbody><tr><td align="right">Web</td><td>false</td><td>true</td></tr><tr><td align="right">Mobile</td><td>false</td><td>true</td></tr><tr><td align="right">Server</td><td>false</td><td>true</td></tr></tbody></table>

## Getting Started

This guide enables you to fully enable the Pinterest Ads destination for your site.  The guide assumes you have the Freshpaint snippet installed on your site, if you do not please follow[ this guide](/readme/guides/quickstart/installing-freshpaint.md).

1. [Find/create your Conversion Access Token](/integrations/destinations/direct-response-ads/pinterest-ads/pinterest-ads-quick-start-guide.md#conversion-access-token)
2. [Find/create your Ad Account ID](/integrations/destinations/direct-response-ads/pinterest-ads/pinterest-ads-quick-start-guide.md#a-d-account-id)
3. [Enable the Freshpaint Pinterest Ads destination](https://documentation.freshpaint.io/readme/setting-up-your-destinations/enabling-and-disabling-a-destination)
   * If in HIPAA mode enable the required/recommended fields
4. [Create a valid event and enable Pinterest for this event](#enable-pinterest-a-ds-events)
5. [Set up action source](#connect-action-source-to-events)
6. [Set Pinterest Ads into test mode](#put-pinterest-a-ds-destination-in-test-mode)
7. [Confirm and validate events](#confirm-and-validate-conversions-in-pinterest)

### Conversion Access Token

To configure your Pinterest Ads destination, you'll first need to create a conversion access token.

1. [Sign in to Pinterest Ads](https://ads.pinterest.com/).
2. Open the menu in the top left corner.
3. In the `Business` column on the right click `Conversions.`
4. On the `Conversions` page in the left menu click `API for Conversions > Conversion Access Token.`
5. Click `Generate New Token.`
6. Copy the new conversion access token.
7. Take notice that you can also see your ad account ID in the paragraph, for example the demonstration ad account ID is `Freshpaint (`555666677123`).`

<figure><img src="/files/MISA6G9w0vDDWVfNMewi" alt=""><figcaption><p>Once you generate the new token you can copy it into a safe document</p></figcaption></figure>

### Ad Account ID

To configure your Pinterest Ads destination events, you'll need to find your Ad Account ID.

1. [Sign in to Pinterest Ads](https://ads.pinterest.com/).
2. Open the menu in the top left corner.
3. In the `Business` column on the right click `Conversions.`
4. On the `Conversions` page in the left menu click `API for Conversions > Conversion Access Token.`
5. Copy the ad account ID in the paragraph, the Freshpaint ad account ID is 555666677123 .
6. You can also copy the Ad Account ID from the URL.

<figure><img src="/files/zI8PVCaziSIrhHFosQu4" alt=""><figcaption><p>Take note that you can see the Ad Account ID 555666677123</p></figcaption></figure>

<figure><img src="/files/ZlgJ2Us8QkSJPgWdBhZ2" alt=""><figcaption><p>Take note of the Freshpaint Ad Account ID in this text.</p></figcaption></figure>

### Enable the Pinterest Ads Destination

To enable the Pinterest Ads destination you simply need to enable and configure it just how you would any other destination.

1. Navigate to the Freshpaint [Apps](https://app.freshpaint.io/destinations/apps).
2. Search for the `Pinterest Ads` advertising destination.
3. Enable `Pinterest Ads.`
4. Paste in your `Conversion Access Token` and `Ad Account ID` in the integration settings.
5. Optional: Customers that use HIPAA mode should then configure `recommended properties` and enable `action_source` and `$epik`.

<figure><img src="/files/QRZfSMoDbtVKHEyg0RjG" alt="" width="375"><figcaption><p>Enabling recommended properties</p></figcaption></figure>

6. Optional: If tracking view-through conversions, enable the recommended view-through conversion properties. Pinterest recommends enabling all 3 properties for the highest quality event data, but requires at least one of either `email` or a combination of `$ip` and `$user_agent` to process conversion events. Read more about Pinterest event quality scoring [here](https://help.pinterest.com/en/business/article/eqs).

<figure><img src="/files/XdKUYaaahU0WBsksBgWv" alt=""><figcaption><p>Allowlisting recommended VTC properties</p></figcaption></figure>

### Enable Pinterest Ads Events

1. Navigate to the [Event Library](https://app.freshpaint.io/events/schema).
2. Select/create an event with a **valid name** (See list of [valid names here](/integrations/destinations/direct-response-ads/pinterest-ads/pinterest-ads-reference.md#valid-event-names)).
   * In this example we are going to create an event called `page_visit` triggering on every page view for demonstration purposes.
3. At the bottom of the event page enable `Pinterest Ads.`

<div data-full-width="false"><figure><img src="/files/ueHgxdscO1kuvHNER7ht" alt="" width="375"><figcaption><p>Creating an event with a valid name </p></figcaption></figure></div>

<figure><img src="/files/gWwZF5Zf6IrV6kLvcVk6" alt=""><figcaption><p>Enabling Pinterest Ads for the event</p></figcaption></figure>

### Put Pinterest Ads Destination in Test Mode

1. Navigate to [Event Transformations](https://app.freshpaint.io/transformations).
2. Click the `Create New` button.
3. Select `Modify Data.`
   * Select your event  (in this demo we will select `page_visit`) .
   * Select `Pinterest Ads` for the destination.
4. Set the following values for the transform fields.
   * `Send Constant Property` for transform type.
   * `test` for property name.
   * `true` or another valid action source (See here for list of valid action sources) for the property value.
   * `True/False` for the property type.
5. When you are done testing **delete** this transformation.

<figure><img src="/files/yaWvL2q6nLxyAUwvNw9u" alt="" width="375"><figcaption><p>Enabling test mode</p></figcaption></figure>

### Confirm and Validate Conversions in Pinterest

1. [Put the Pinterest Ads destination into test mode](/integrations/destinations/direct-response-ads/pinterest-ads/pinterest-ads-quick-start-guide.md#put-pinterest-a-ds-destination-in-test-mode).
2. Open the test event panel on Pinterest Business page.
   1. [Sign in to Pinterest Ads](https://ads.pinterest.com/).
   2. Open the menu in the top left corner.
   3. In the `Business` column on the right click `Conversion.`
   4. Click `Test Events.`
3. On a new tab navigate to your site and visit a page that should trigger your event (For demonstration purposes we will use [FreshHealth.co](https://www.freshhealth.co/)).
4. Add a query parameter called `epik` to the URL (Example: [https://www.freshhealth.co/?epik=TEST](https://www.freshhealth.co/)).
5. Trigger your event (Our demonstration event is `page_visit`).
6. Navigate to the [Event Verification tool](https://app.freshpaint.io/event-verification).
7. Select `Pinterest Ads` and verify your event went through.
   * This can take up to 90 seconds.
8. Verify the event is marked as `OK` or resolve missing property issues.
9. Verify the event appears on the Pinterest test event page.
10. Delete the `test` transformation, otherwise real events will not send to Pinterest.

<figure><img src="/files/1mvmCKFquCFKClbSzD5u" alt=""><figcaption><p>Our Pinterest Ads event went through smoothly with all required properties in place</p></figcaption></figure>

<figure><img src="/files/bgUBJCHe3fq4XaIA7xXG" alt=""><figcaption><p>Our event is looking good on the Pinterest test event page</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.freshpaint.io/integrations/destinations/direct-response-ads/pinterest-ads/pinterest-ads-quick-start-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.