Setting Up a Webhook Integration

In this article:
1. What is a webhook?
2. Requesting a new webhook
3. Finding and editing a webhook

Additional Resources:
1. Figuring out which webhook type you will need to use
2. Building an integration on top of ActBlue Default webhooks
3. For vendors: Requesting a webhook


ActBlue webhooks are a way to connect your ActBlue contribution data to third-party services like a content management system, mailer, or customer relationship management system.


What is a Webhook?

A webhook is a way to notify when an event has occurred. When you receive a contribution through ActBlue, we’ll send this information to the location (endpoint URL) you provide. Here at ActBlue, we can notify you when three different kinds of events happen: contributions, refunds, and recurring contribution cancellations.

Contribution data is described in the notifications as contributions from donors to entities. These notifications include the donor's name, address, employer, contribution form used to make a donation, and other personal information. You can find more information about what’s included in these notifications here.

You can request a new webhook right in the Webhooks Integrations tab of your Dashboard! First you will have to choose the webhook type you need from a dropdown menu. This depends on the service you are trying to connect with or whether you’re building a custom integration. Take a look at our guide on webhook types to understand which one you will need.

Here are the third-party services ActBlue already offers webhook integrations for:

  • ActionKit 2.0
  • ActionNetwork
  • Blue State Digital
  • CallTime
  • NGP Digital 8
  • Numero.ai
  • Salesforce
  • Salsa

If the service you use isn’t on our list of webhook types, you have the option to send your vendor our Vendor Form to request a webhook.


Requesting a New Webhook

Step 1: Click the Webhooks Integrations tab in your Dashboard 

In your Dashboard toolbar, click the Webhooks Integrations tab under the “Tools” section. If you have set up webhooks in the past, you’ll see a list of your requested, active, and inactive webhooks on this page.

Step 2: Request a new webhook 

Click the “Request a new webhook” button at the top right. Nav1

Step 3: Select the webhook type you need from the dropdown menu Nav1

After choosing the webhook you need, click “Next.”

Step 4: Enter some basic information 

You first have the option to include a nickname for your webhook. Although not required, we recommend you add a nickname to help you differentiate webhooks of the same type.

Next, enter the email of the main point of contact at your campaign or organization. This is the email we will reach out to about activating your webhook, so make sure this contact information is accurate!

Nav1

Step 5: Enter your endpoint and credentials 

The endpoint URL and credentials required in this section are different depending on the webhook type you are using. Please check our guide on webhook types to find more information about the specific information you will need for the webhook type you are using.

This is an example of the endpoint URL and credentials you would need for an ActBlue Default webhook: Nav1

The “Endpoint URL” is where you’d like ActBlue to send your contribution data, and it needs to be a secure URL that begins with “https://”

The “Username” and “Password” fields are the credentials for your endpoint.

Step 6: Optional: Include a “Backfill” date 

If you are setting up a webhook for the first time and have previous donations with ActBlue for which you would like to receive notifications, we can send them to you with our "backfill" feature.

Select the date from which you would like the contribution data to begin under “Requested backfill start date (optional).” All backfills run from the start date through the date the webhook is activated!

Nav1

Step 7: Submit the webhook request! 

Once you’ve entered all of the required information, click the “Submit request” button at the bottom. Please note that your webhook request must first be approved by ActBlue before the webhook can be activated and you begin to receive contribution notifications.

Nav1

Step 8: The ActBlue team will follow up 

After you submit your webhook request, we’ll review it and then reach out to the webhook contact you specified in your request once the webhook is active!


Finding and Editing a Webhook

You can always find your webhooks by clicking the Webhooks Integrations tab of your Dashboard toolbar. You will see any requested, active, or inactive webhooks you have!

You can edit a webhook by clicking on the “Edit” button next to it.

Nav1

Here you can make updates to the webhook’s basic information, like nickname, email of your group’s point of contact, and any credentials that might have changed. After making any updates, click “Save.”

If you have requested a backfill of past ActBlue contributions, you cannot edit the start date you specified for the backfill. Please reach out to your ActBlue contact to request another backfill!

Paid for by ActBlue (actblue.com) and not authorized by any candidate or candidate's committee.
Contributions or gifts to ActBlue are not deductible as charitable contributions for Federal income tax purposes.