How to Set up ActBlue Integration in ISP Software

Our integration partners sometimes make updates to their system that we are unaware of. If the steps provided in our help file don’t match what you see on their site, please contact our support team and we will assist you in getting the integration properly set up.

We pull data from ActBlue via an API when new donations are processed. If a donation is recurring monthly, ActBlue will provide us with a new donation each month. From our standpoint, nothing in the information we receive indicates it is recurring. We also don’t support pre-entry because recurring donations sometimes fail or are canceled.

When transactions come over from ActBlue, we respect the timezone that ActBlue specifies. For example, if a transaction is sent to us on August 2nd from ActBlue at 1:00 am Eastern Time, even though that is August 1st at 10:00 pm Pacific to ISP, the system will treat that as an August 2nd transaction.

You can control how your ActBlue transactions come into ISP through the ActBlue integration page.

You can also control your ActBlue transactions through the Auto-Import settings on the ai@ISP page.

How do I add the ActBlue integration?

Part 1: Turn on the integration in ISP

In ISP, go to the Integrations tab and select Add/Remove Integrations.
In the search bar, type ActBlue. Then click ActBlue to install it.
An Add Integration window opens. In the ActBlue Entity Id field, enter your Entity ID. To find it, log in to ActBlue and look at your browser’s address bar. Your Entity ID is the 5- or 6-digit number after “entities/”. For example, in fundraising.app.actblue.com/entities/123456/insights, the Entity ID is 123456.
Click Add Integration. Wait for the success message. Your ActBlue Settings page opens.
Keep this page open. You will copy from it in the next part.

Part 2: Create the Donations webhook in ActBlue

Open a new browser tab and log in to ActBlue.
In the left menu, under Tools, click Integrations.
On the Webhooks box, click Manage.
Click the green Create a new webhook button.
In the Webhook event type dropdown, choose ActBlue Default. Click Next.
In the Endpoint URL field, paste the Donations URL from your ISP ActBlue Settings page. Copy the whole URL, including “AccountId=” and the number at the end. It looks like this, with your account number in place of the X’s:
https://app.ISPolitical.com/API/WebHooks/ActBlueDonations?AccountId=XXXXX
In the Username field, delete anything already there. Then type ActBlue.
In the Password field, delete anything already there. Then paste the Password from your ISP ActBlue Settings page.
Optional: To import past donations, pick a Backfill start date. Leave it blank to import only new donations.
Optional: If you picked a start date, pick a Backfill end date.
Click the button at the bottom of the form to create the webhook.

Important: Your browser may automatically fill in the Username and Password fields with your own ActBlue login. This is the most common setup mistake. Always clear both fields before you enter the ISP credentials.

Part 3: Create the Refunds and Cancellations webhooks

Repeat steps 4 through 11 from Part 2 two more times. Change only steps 5 and 6.

For the Refunds webhook:

Step 5: Choose ActBlue Default Refunds.
Step 6: Paste the Refunds URL from ISP. It looks like this: https://app.ISPolitical.com/API/WebHooks/ActBlueRefunds?AccountId=XXXXX

For the Cancellations webhook:

Step 5: Choose ActBlue Default Cancellations.
Step 6: Paste the Cancellations URL from ISP. It looks like this: https://app.ISPolitical.com/API/WebHooks/ActBlueCancellations?AccountId=XXXXX

Once all steps are complete, ActBlue donations will appear in the Pending Imports section of the Dashboard within about 24 hours. If you use a customized dashboard in ISP, include the Pending Imports section in the customization, or you will not see data from ActBlue that needs to be imported into your database.

Once the integration is set up, the system will automatically create an ActBlue organization record in the account with ActBlue’s details. We also suggest manually creating an ActBlue Technical Services organization record for any fees incurred from ActBlue.

Regarding the dates on these transactions, ActBlue sends the contribution data in real time as it is made. That is part of the process they have set up for integrations overall. While the conduit check can have the date received, the contributions would have the date given.

Please note that temporary duplicate contact information is expected with imports. The cleanup process, which typically runs within an hour of the import, should automatically clean up the duplicate contact information.

How do I add more than one ActBlue integration?

If you have more than one ActBlue account and need to set up a second integration into the same ISP account, you can enter additional ActBlue Entity IDs in the ActBlue Entity section.

To learn how data from this integration enters your account, see How Does Data From My Integration Get Into ISP?

How Do I Set Up an ActBlue Integration?

How do I add the ActBlue integration?

Part 1: Turn on the integration in ISP

Part 2: Create the Donations webhook in ActBlue

Part 3: Create the Refunds and Cancellations webhooks

How do I add more than one ActBlue integration?

Related Information

Not using ISP yet?