# Spotify Conversions API Quick Start Guide

{% hint style="warning" %}
The Spotify Conversions API 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 **Spotify Conversions API** 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 Spotify 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 Spotify **Connection ID**
2. Find/create your Spotify **Access Token**
3. Enable the Freshpaint Spotify destination
   * If in HIPAA mode enable the required fields
4. Confirm and validate events

### Find your Spotify Connection ID

If you do not have an existing Spotify data source, please refer to the "Create a new Spotify Connection" section instead.

1. Log in to your [Spotify Ads Manager](https://adsmanager.spotify.com/).
2. From the top-left menu select **Events.**

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

3. Click on the data source you'd like to use (Note: this must be a Conversions API data source as it will not work with a Spotify Pixel data source).

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

4. From the data source page, click **View Instructions.**

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

5. Copy the **Connection ID** and copy or generate token as needed.

<figure><img src="/files/37MDbclY2RDuKHsQ9cjz" alt=""><figcaption></figcaption></figure>

### Create a new Spotify Connection

If you already have an existing Spotify data source you'd like to use, please refer to the "Find your Spotify Connection ID" section instead.

1. Log in to your [Spotify Ads Manager](https://adsmanager.spotify.com/).
2. From the top-left menu select **Events.**

<figure><img src="/files/3pMuIIssLQ1JbBWtDuIN" alt=""><figcaption></figcaption></figure>

3. Click on the **Connect Data Source** button and choose the **Conversions API** option

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

4. Choose a name for the source and optionally choose the ad accounts with access

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

5. You will next be guided to a page that has your **Connection ID**. Click the **Generate Token** button in order to set up the needed authentication.
6. Copy the **Connection ID** and copy or generate token as needed.

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

### Enable the Freshpaint Spotify Conversions API destination

1. Navigate to the [Freshpaint Destinations page](https://app.freshpaint.io/destinations/catalog).
2. Search for the **Spotify Conversions API** destination.
3. Select **Configure** to paste your **Connection ID** and **Access Token** 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 Spotify integration supports here: [Spotify Conversions API Reference](/integrations/destinations/direct-response-ads/spotify-conversions-api-early-access/spotify-conversions-api-reference.md).
5. Enable Spotify.

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

<figure><img src="/files/fkNlLZlcRg6U4zdd6zHE" 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
2. Trigger your event (Our demonstration event is a `Sign Up`).
3. Navigate to the [Event Verification tool](https://app.freshpaint.io/event-verification).
4. Select `Spotify Conversions API` and verify your event went through.
   * This can take up to 90 seconds.
5. Verify the event is marked as `OK` or resolve missing property issues.

<figure><img src="/files/L517sv4veSt5BOtupYJK" alt="Image of an OK SIGN_UP event for Spotify Conversions API"><figcaption><p>Our Spotify event went through smoothly with all required properties in place</p></figcaption></figure>

### Confirm and Validate Conversions in Spotify

To check whether Spotify is receiving events.

1. Log in to your Spotify Ads Manager.
2. From the top-left menu select **Events.**
3. See that your data source has a status of Receiving. Click to spot check events.
4. You should see events coming through under the large graph under **Event Activity** on this page.

<figure><img src="/files/0E6HxOfTvBlyHppw3OJz" alt=""><figcaption></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/spotify-conversions-api-early-access/spotify-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.