# StackAdapt Audiences

Freshpaint Audiences allows you to sync your segmented or imported audiences to StackAdapt Audiences — all while enabling you to maintain compliance with privacy regulations like HIPAA.

{% hint style="info" %}
In StackAdapt, these will appear as audience segments, even though Freshpaint refers to them as “Audiences.”

* Imported audiences sync as a CRM segment (contains emails only)
* Segmented audiences sync as an IP segment
  {% endhint %}

This guide walks through how to set up and verify your connection between Freshpaint and your StackAdapt account.

### StackAdapt account requirements

The following must be **true** about the StackAdapt account you use for this integration:

1. Your StackAdapt account is in good standing with StackAdapt and not in violation of their advertising policies.
2. You have a StackAdapt GraphQL API Token.

{% hint style="info" %}
If you do not have a StackAdapt GraphQL API Token already, you can request one from your StackAdapt account managers or account executives. Make sure to associate the GraphQL API Token with the StackAdapt advertiser ID you intend to use for this Freshpaint integration.
{% endhint %}

### Connect StackAdapt account to Freshpaint

1. To begin, select the **StackAdapt** **Audiences** option from [Freshpaint’s Integration Catalog](https://app.freshpaint.io/destinations/catalog?category=audiences).

<figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FqKno4f7O6b5UJkzqpC36%2FDestinations%20-%20Catalog%20-%20Audience%20targeting%201%20(1).png?alt=media&#x26;token=dcd953e1-cf61-4be5-8631-1d1ab259e8a9" alt=""><figcaption></figcaption></figure>

2. On the StackAdapt Audiences configuration page, select the **Configure** option on the right side and enter your **StackAdapt Advertiser ID** (looks like `12345`).<br>

   <figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2F5ViQP3xZLStOXRxpEZ32%2Fimage.png?alt=media&#x26;token=2faa3d3e-1608-4be5-b796-45e363459e7f" alt=""><figcaption></figcaption></figure>

3. Enter your **StackAdapt GraphQL API Token** (looks like `7jzlexo50wydqrvuzevf65yhf5zfvb0zxigabgw7jphrzbmd6jh843u1a6s368p5`).<br>

   <figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FLE5J0b5kEZLNFjzXzDn9%2Fimage.png?alt=media&#x26;token=50f642f7-4d06-4403-8173-771802cc16e3" alt=""><figcaption></figcaption></figure>

4. Enable identity matching.<br>

   <figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FROi6nAk0RxJrtawBh5e6%2Fimage.png?alt=media&#x26;token=7d380696-cf42-4adb-bc68-d077ae3a0848" alt=""><figcaption></figcaption></figure>

5. Click **Configure** next to the **Audience Identifiers** row to grant Freshpaint the required HIPAA allowlist permissions needed to send StackAdapt IPs and email addresses of your events. Then click the **"I confirm"** checkbox and select **"Save"**.<br>

   <figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2F89Y8IQMoTRryrhL6xiIS%2Fimage.png?alt=media&#x26;token=c2216c67-b429-4c2e-a67d-ec3e9f68a36d" alt=""><figcaption></figcaption></figure>

6. Verify your connection with StackAdapt's GraphQL API by clicking the **Test connection** button at the bottom of the screen. This tests that:
   1. Your StackAdapt GraphQL API token is valid, and not expired.
   2. Your StackAdapt GraphQL API token is allowed to interact with resources associated with the StackAdapt advertiser ID you configured in the Freshpaint integration.<br>

      <figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FK25iknSIwjKhn1w3qoqT%2Fimage.png?alt=media&#x26;token=d41c5f5b-1a10-4cb2-b2a7-6cd5d89f7393" alt=""><figcaption></figcaption></figure>

7. Finally, click the **Add label** button at the top of the screen to add a label to your integration. This label will help you keep track of this integration within Freshpaint.<br>

   <figure><img src="https://1666823438-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MA7aDqsXMFbUsWVqonF%2Fuploads%2FGlBomDAObRlmNVoJ8SJB%2Fimage.png?alt=media&#x26;token=d8f63f86-0f3b-443c-9463-a72379bc5ea0" alt=""><figcaption></figcaption></figure>

✅ That’s it! Your StackAdapt Audiences integration is now ready to use.

{% hint style="info" %}
💡 After you sync an audience from Freshpaint, you’ll manage it in StackAdapt as an audience segment. Imported audiences map to CRM segments (email), while segmented audiences map to IP segments.\
\
💡 You can find it in StackAdapt under **Programmatic Audiences** → **My Audiences**.
{% endhint %}

💡 Learn more (StackAdapt Academy)

* [Audiences in StackAdapt](https://academy.stackadapt.com/audiences-in-stackadapt-us-ca-1/9350)
* [Audiences overview lesson](https://academy.stackadapt.com/audiences-overview-4001)

### Custom Consent Manager Integration

* Refer to this destination as **Audiences** in the [Consent object](https://documentation.freshpaint.io/integrations/consent-management/custom-consent-manager)

💡 **Need help?**

If you're unsure how to to set up your StackAdapt Audiences integration, please reach out to our team at <support@freshpaint.io>.
