---
title: ActBlue Integration
description: Learn how to set up the Scale to Win ActBlue Integration to automatically sync donation data, upload contacts, and subscribe donors to your shortcode. This step-by-step guide covers webhook setup, API credential creation, and campaign contact sync options.
---
[Skip to content](https://support.scaletowin.com/act-blue-integrations-how-to-set-up#main-content)
English
Show submenu for translations
[](https://www.scaletowin.com/)
Open main navigation
Close main navigation
- English
Show submenu for translations
- [Contact us](https://support.scaletowin.com/contact)
[Contact us](https://support.scaletowin.com/contact?hsLang=en)
Hi! How can we help?
- There are no suggestions because the search field is empty.
1. [Scale to Win](https://support.scaletowin.com/?hsLang=en)
2. [Scale to Win Text](https://support.scaletowin.com/scale-to-win-text?hsLang=en)
3. [Integrations & Data Management](https://support.scaletowin.com/scale-to-win-text?hsLang=en#integrations-data-management)
# ActBlue Integration
| **TABLE OF CONTENTS** |
| --- |
| - [Set Up Your ActBlue Continuous Updates (Webhook)](https://support.scaletowin.com/act-blue-integrations-how-to-set-up#how-to) - [Getting Your Credentials](https://support.scaletowin.com/act-blue-integrations-how-to-set-up#credentials) - [Requesting Your Webhook](https://support.scaletowin.com/act-blue-integrations-how-to-set-up#requesting) - [Set up ActBlue Contact Upload](https://support.scaletowin.com/act-blue-integrations-how-to-set-up#set-up) - [Generate Client UUID and Secret from ActBlue](https://support.scaletowin.com/act-blue-integrations-how-to-set-up#generate-credentials) - [Upload Credentials in Scale To Win Text](https://support.scaletowin.com/act-blue-integrations-how-to-set-up#upload) - [Load an ActBlue Contact List in a Campaign](https://support.scaletowin.com/act-blue-integrations-how-to-set-up#load) - [Subscribe Donors to Short Code](https://support.scaletowin.com/act-blue-integrations-how-to-set-up#short-donors-code) |
Scale to Win supports two ways to get data from ActBlue:
- **ActBlue One-Time Import (API):** Import historical ActBlue donors and access ActBlue donation history in Scale to Win.
- **ActBlue Continuous Updates (Webhook):** Receive new ActBlue donation activity in Scale to Win as it happens. Organizations with an opt-in subscriber program can also use the Webhook to add qualifying donors to their Subscriber Audience.
You can set up either or both integrations depending on your workflow.
### **Set Up Your ActBlue Continuous Updates (Webhook)**
### Getting Your Credentials
1. First, navigate to the **Integrations** page in Scale to Win Text.
2. Click **Add New Integration** and choose "ActBlue Donation Webhook".
3. Assign a name for quick reference, especially if you plan to connect multiple ActBlue instances, then click **Create**.
4. After selecting the ActBlue Donation Webhook, you'll receive an endpoint URL, username, and password. Save this information.
.png?width=670&height=314&name=Getting%20your%20credentials%20-%20webhook%20(1).png)
.png?width=570&height=516&name=Getting%20your%20credentials%20-%20webhook%20(2).png)
### Requesting Your Webhook from ActBlue
1. Open your ActBlue dashboard and go to **Tools** → **Integrations** → **Webhooks** → **Manage**.
2. Choose **Request a New Webhook**, and select **ActBlue Default** as the type. Ensure the contact email is accessible to you, and input the endpoint URL, username, and password obtained from Scale to Win Text earlier.
1. If you have an active Shortcode, an additional dropdown will appear that prompts you to select if you’d like your donors to be automatically subscribed/opted in. They will receive your registered opt-in message.
3. Click **Submit Request** to initiate the ActBlue webhook request.
4. ActBlue will then review the webhook request before activation. This process typically takes around 5 business days. If it takes longer, you may need to follow up with ActBlue.
5. Once approved, ActBlue notifies you via email, and the webhook becomes active.
The ActBlue Continuous Updates (Webhook) integration receives donation activity in real time. When ActBlue link tracking is enabled, Scale to Win can associate those donations with contacts and campaign ROI.
---
### **Set Up Your ActBlue One-Time Import (API)**
### Generate Client UUID and Secret from ActBlue
1. In ActBlue, create new API credentials by navigating back to the Dashboard and selecting **API Credentials** under **Admin**.
2. From this page, you’ll be able to name and generate a new API Credential. Once you do, you’ll receive the Client UUID and Secret. Make sure to save this information in a safe place, because you will need to input it in Scale to Win Text to complete the setup in the next steps.
### Upload Credentials in Scale To Win
1. Return to the **Integrations** page in Scale to Win Text, select **Add New Integration**, and then **ActBlue One-Time Import (API)**.
2. Assign a name for quick reference, especially when connecting multiple ActBlue instances. Upload the Client UUID and Secret obtained from ActBlue into the form.
3. Click **Create**, and you’re done! The tool will tell you right away if the integration is successful, or if you need to edit the information you’ve added.
### **Load contacts into a Campaign using ActBlue**
**1.** Once you’ve set up the ActBlue One-Time Import (API), you can load contacts during **Step 3: Load Contacts** of Campaign Build. Select **ActBlue One-Time Import (API)**.
.png?width=650&height=462&name=Load%20an%20ActBlue%20Contact%20List%20in%20a%20Campaign%20(3).png)
**2.** You can filter the contacts by:
1. 1. date range of donation
2. minimum and maximum donation amount
3. donation device
4. donation type
5. and associate refcode from a previous campaign sent using the ActBlue Webhook — Ongoing Updates integration.
.png?width=604&height=668&name=AB%20sync%20filter%20contacts%20(4).png)
**Note:** Only donors with a donation during the selected date range that matches all selected filters will be imported.
3. Click **Load Contacts.**
### **Import ActBlue Donors into an Audience**
The ActBlue One-Time Import (API) can be used to import historical ActBlue donors into an Audience.
This integration is for one-time historical imports.
1. Open the Audience you want to add contacts to and select **Add Contacts**.
2. Choose **ActBlue One-Time Import (API).**
3. Choose the donation date range you want to import.
4. If needed, use **Advanced Filters** to narrow the contacts included in the import by:
5. Donation amount
6. Donation device
7. Donation type
8. Refcode
9. Expand **Custom Fields (optional)** to map other ActionKit data to the corresponding Audience fields.
10. Click **Upload**.
### 
If you want to map ActBlue data to custom fields, create those fields in Audience Settings before starting the import.
### **Add ActBlue Donors to Your Subscriber Audience**
**Note:** This section is for organizations with an opt-in subscriber program.
You can configure your ActBlue Continuous Updates (Webhook) integration to add qualifying donors to your Subscriber Audience.
1. Go to the **Integrations** page in Scale to Win Text.
2. Find your **ActBlue Continuous Updates (Webhook)** integration and select theedit pencil.
3. Under **Subscribe donors to your opt-in audience?**, choose which donors should be added:
4. **No:** Do not automatically add donors to your Subscriber Audience.
5. **Explicit Opt-Ins:** Add donors who explicitly opted in through ActBlue.
6. **Explicit Opt-Ins and Unknowns:** Add both explicit opt-ins and donors whose opt-in status is unknown.
1. To send a custom donation thank you message to your subscribed donors, toggle on **Send donation thank you message.**
2. Add the message text in the field below. You can also upload an image to make it an MMS.
3. Click **Save**.
- [Scale to Win Text](https://support.scaletowin.com/scale-to-win-text?hsLang=en#main-content)
- [Getting Started](https://support.scaletowin.com/scale-to-win-text?hsLang=en#getting-started)
- [Creating Text Campaigns](https://support.scaletowin.com/scale-to-win-text?hsLang=en#creating-text-campaigns)
- [Navigating Your Menu & Features](https://support.scaletowin.com/scale-to-win-text?hsLang=en#navigating-your-menu-features)
- [Integrations & Data Management](https://support.scaletowin.com/scale-to-win-text?hsLang=en#integrations-data-management)
- [Best Practices, Troubleshooting & FAQs](https://support.scaletowin.com/scale-to-win-text?hsLang=en#best-practices-troubleshooting-faqs)
- [Glossary](https://support.scaletowin.com/scale-to-win-text?hsLang=en#glossary)
- [Scale To Win Text | Phone Number Registration](https://support.scaletowin.com/scale-to-win-text-phone-number-registration?hsLang=en#main-content)
- [10DLC](https://support.scaletowin.com/scale-to-win-text-phone-number-registration?hsLang=en#10dlc)
- [Short Code](https://support.scaletowin.com/scale-to-win-text-phone-number-registration?hsLang=en#short-code)
- [Compliance Guidelines](https://support.scaletowin.com/scale-to-win-text-phone-number-registration?hsLang=en#compliance-guidelines)
- [Scale To Win Text | Phone Number Types](https://support.scaletowin.com/scale-to-win-text-phone-number-types?hsLang=en#main-content)
- [10DLC](https://support.scaletowin.com/scale-to-win-text-phone-number-types?hsLang=en#10dlc)
- [Short Code](https://support.scaletowin.com/scale-to-win-text-phone-number-types?hsLang=en#short-code)
- [Scale To Win Text | Guides for Texters](https://support.scaletowin.com/scale-to-win-text-guides-for-texters?hsLang=en#main-content)
- [Getting Started](https://support.scaletowin.com/scale-to-win-text-guides-for-texters?hsLang=en#getting-started)
- [Texter View](https://support.scaletowin.com/scale-to-win-text-guides-for-texters?hsLang=en#texter-view)
- [Scale to Win Dialer](https://support.scaletowin.com/scale-to-win-dialer?hsLang=en#main-content)
- [Getting Started](https://support.scaletowin.com/scale-to-win-dialer?hsLang=en#getting-started)
- [Creating Call Campaigns](https://support.scaletowin.com/scale-to-win-dialer?hsLang=en#creating-call-campaigns)
- [Features](https://support.scaletowin.com/scale-to-win-dialer?hsLang=en#features)
- [Navigating Your Menu](https://support.scaletowin.com/scale-to-win-dialer?hsLang=en#navigating-your-menu)
- [Managing Call Campaigns](https://support.scaletowin.com/scale-to-win-dialer?hsLang=en#managing-call-campaigns)
- [Integrations & Data Management](https://support.scaletowin.com/scale-to-win-dialer?hsLang=en#integrations-data-management)
- [Caller Academy | Guides for Callers](https://support.scaletowin.com/caller-academy-guides-for-callers?hsLang=en#main-content)
- [Getting Started](https://support.scaletowin.com/caller-academy-guides-for-callers?hsLang=en#getting-started)
- [Making Calls & Clicking](https://support.scaletowin.com/caller-academy-guides-for-callers?hsLang=en#making-calls-clicking)
- [Billing](https://support.scaletowin.com/billing?hsLang=en#main-content)
- [Setting up your billing portal](https://support.scaletowin.com/billing?hsLang=en#setting-up-your-billing-portal)
- [Payment Methods](https://support.scaletowin.com/billing?hsLang=en#payment-methods)
- [Understanding Charges](https://support.scaletowin.com/billing?hsLang=en#understanding-charges)
[](http://scaletowin.com)
Copyright © 2025, Scale to Win