# Snapchat Conversions API Quick Start Guide

{% hint style="warning" %}
The Snapchat destination is currently in Early Access. Please contact <support@freshpaint.io> for more information about this integration.
{% endhint %}

## Destination Info

* Supports [Track](https://documentation.freshpaint.io/developer/freshpaint-sdk-reference#track) calls
* Supports [HIPAA mode](https://documentation.freshpaint.io/hipaa-mode)
* Refer to this destination as **Snapchat** 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 Snapchat Conversions API destination for your site.  For simplicity the event used for demonstration purposes is the generic `Page View` event.  For more complex events see[ our additional documentation](/readme/setting-up-your-events.md).  Additionally this 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).&#x20;

1. [Find/create your Snapchat Pixel ID](#find-create-your-snapchat-pixel-id)
2. [Find/create your Snapchat Authentication Token](#find-create-your-snapchat-authentication-token)
3. [Enable the Freshpaint Snapchat destination](#enable-the-freshpaint-snapchat-destination)
   * If in HIPAA mode enable the required fields
4. Confirm and validate events

### Find/create your Snapchat Pixel ID

1. Log in to your [Snapchat Ads Manager](https://ads.snapchat.com/).
2. From the top-left menu select **Pixels.**
3. Create or view your existing Pixel.
4. Copy the **Pixel ID** from the top of the Pixel Details page.

<figure><img src="/files/pnEDnF3H5nD97pYbU6aS" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/S16AVOjh6bTywwpvsxrL" alt=""><figcaption></figcaption></figure>

#### Associate your Pixel with your Ad Account

Select the Ad Account from the drop down on the Pixel Details page that you want to associate with your Pixel. This enables you to view your event details and performance in the Snapchat **Events Manager.**

<figure><img src="/files/Kbw5THlQPOQ3PVhl71zC" alt=""><figcaption></figcaption></figure>

### Find/create your Snapchat Authentication Token&#x20;

From the Pixels page or from the **Business Dashboard** in the top-left menu, select **Business Details** on the left-side menu.

<figure><img src="/files/gKbKNaJWN01p9ZWZCnuS" alt=""><figcaption></figcaption></figure>

Scroll down to the **Conversions API Tokens** section and click **Generate Token.**

<figure><img src="/files/bpUCyScywiaoEsdi13uA" alt=""><figcaption></figcaption></figure>

After creating your token, you can hover your mouse over the row to copy the token value.

<figure><img src="/files/gHSCo2yjC96oZRHSIN3k" alt=""><figcaption></figcaption></figure>

### Enable the Freshpaint Snapchat destination

1. Navigate to the [Freshpaint Destinations page](https://app.freshpaint.io/destinations/catalog).
2. Search for the **Snapchat** destination.
3. Select **Configure** to paste your Pixel ID and API Key from the above steps.
4. Customers that use HIPAA mode should then configure the required, recommended, and recommended view-through properties. You can find [all properties that the Freshpaint Snapchat integration supports here.](/integrations/destinations/direct-response-ads/snapchat-conversions-api/snapchat-conversions-api-reference.md)
5. Enable Snapchat.

Once you've followed the steps above you can start sending events to Snapchat Conversions API.&#x20;

<figure><img src="/files/yU6Q3vcicit6r4t6Fybx" alt=""><figcaption></figcaption></figure>

## Confirm and validate events

### Confirm and Validate Conversions in Freshpaint

1. 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/)).
2. Add a query parameter called `sccid` to the URL <mark style="color:$info;">(Example:</mark> [<mark style="color:$info;">https://www.freshhealth.co/?sccid=TEST</mark>](https://www.freshhealth.co/?sccid=TEST)<mark style="color:$info;">).</mark>
3. Trigger your event (Our demonstration event is any `Page View`).
4. Navigate to the [Event Verification tool](https://app.freshpaint.io/event-verification).
5. Select `Snapchat` and verify your event went through.
   * This can take up to 90 seconds.
6. Verify the event is marked as `OK` or resolve missing property issues.

<figure><img src="/files/SpVY1aUs4f0i2TUDuhQK" alt=""><figcaption><p>Our Snapchat event went through smoothly with all required properties in place</p></figcaption></figure>

### Confirm and Validate Conversions in Snapchat

To check whether Snapchat is receiving events.

1. Log in to your [Snapchat Ads Manager](https://ads.snapchat.com/).
2. From the top-left menu select **Events Manager.**
3. Select **Events Sources > Event Manager** in the left-side menu.
4. You should see events coming through under the large graph under **Event Details** on this page

<figure><img src="/files/J9RuAkLkGJXrLwo0T2ig" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/SF7OvGeFsDZzY2Rz8jzj" alt=""><figcaption></figcaption></figure>

There is more information on how to understand and use this page in the [Snapchat documentation.](https://businesshelp.snapchat.com/s/article/App-Details-in-Events-Manager?language=en_US)


---

# 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/snapchat-conversions-api/snapchat-conversions-api-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.