# 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.

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="/files/prAvV8srVV24QtE40IkY" 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="/files/5FN4iN5BPo4fT26JU4sC" alt=""><figcaption></figcaption></figure>

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

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

4. Enable identity matching.<br>

   <figure><img src="/files/cCFJznOJVmeR4FX33aPE" 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="/files/XPLH5q7hdvp3K6LN82zx" 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="/files/eU6lh6NMgADFMbeiQRdl" 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="/files/JTSM0IWHqj1yzKv5BTT8" alt=""><figcaption></figcaption></figure>

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

### Custom Consent Manager Integration

* Refer to this destination as **Audiences** in the [Consent object](/~/revisions/1894FoJxnjRBjmFtxKk0/integrations/destinations/consent-management/custom-consent-manager.md)

💡 **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>.


---

# 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/~/revisions/1894FoJxnjRBjmFtxKk0/audiences/audience-integrations/stackadapt-audiences.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.