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.

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

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.

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.

Connect StackAdapt account to Freshpaint

1. To begin, select the StackAdapt Audiences option from Freshpaint’s Integration Catalog.

1. On the StackAdapt Audiences configuration page, select the Configure option on the right side and enter your StackAdapt Advertiser ID (looks like 12345).

   

2. Enter your StackAdapt GraphQL API Token (looks like 7jzlexo50wydqrvuzevf65yhf5zfvb0zxigabgw7jphrzbmd6jh843u1a6s368p5).

   

3. Enable identity matching.

   

4. 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".

   

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

      

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

   

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

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

💡 Learn more (StackAdapt Academy)

• Audiences in StackAdapt

• Audiences overview lesson

Custom Consent Manager Integration

• Refer to this destination as Audiences in the Consent object

💡 Need help?

If you're unsure how to to set up your StackAdapt Audiences integration, please reach out to our team at [email protected].