Use ActiveCampaign webhooks

With ActiveCampaign, you can use webhooks to send real-time updates about your contact and campaign activity to an outside source. 

What is a webhook?

Webhooks are automated messages sent from one system to another when a specified event occurs. You can use webhooks to send data from your ActiveCampaign account to update an external database or application with contact, campaign, deal, and custom object activities as they happen. 

For example, you may want to create a webhook to send data to an external database every time a contact record is updated, when an account is added, when a deal task is created, or when a contact clicks a link in your email. 

Note that when creating a webhook, the receiving application must accept POST requests and have an API. ActiveCampaign does not accept incoming webhooks.

Webhook types

ActiveCampaign offers two types of webhooks: Standard and Custom.

Standard webhooks

Available on all ActiveCampaign plans

Use Standard webhooks to post data to a third-party source when an action occurs with Contacts (all plans), Campaigns (all plans), Deals (Plus, Professional, and Enterprise plans), Accounts (Plus, Professional, and Enterprise plans), and SMS messages (Plus, Professional, and Enterprise plans).

Custom webhooks

Available on Enterprise plans.

Use Custom webooks to post data to a third-party source when an action occurs with a custom object, including custom objects imported from a supported third-party integration and custom objects you create using the API or the “Manage Data” page in your account.

Where webhooks are created

There are two different places where you can create a webhook in ActiveCampaign: Developer Settings and Automation. 

Developer Settings under My Settings

Will post data to a third-party source every time a specified action(s)/event is completed.

Standard and custom webhooks are created here.

Webhook automation action

Will post data to another URL once a contact interacts with the Webhook action in an automation.

This action only works with Standard webhooks. Custom webhooks do not work with this automation action. 

You do not need to create a webhook under "Developer Settings" to send a webhook from an automation. Learn how to send a webhook from an automation.

Learn how to send a webhook from an automation

How to create a standard webbook under Developer Settings

With this setup, you need to choose the contact list that the webhook will be associated with, the URL to send data to, the event that will trigger the webhook to send data, and from where the webhook should run. 

  1. Click "Settings" then click "Developer."
  2. Click the "Manage Webhooks" button.
  3. Click the "Add" button.
  4. Select "Standard" for the webhook type.
  5. Click the "List" dropdown and select the list with which your webhook will be associated. 
  6. Type the name of the webhook into the "Name" field. 
  7. Type the URL of the outside source that will receive the webhook data. 
  8. Choose the event that will trigger the webhook to send data to your outside source. Note that you can select more than one event. 
  9. Choose an initiation option:
    • By a contact - Runs when a contact causes the action. For example, when a contact subscribes to your list or opens your campaign
    • By an admin user - Runs when an admin user causes the action. For example, when an admin user creates a new contact record
    • By the API - Runs when API call causes the action. For example, adding a contact using contact_add API call
    • By system processes - Runs when automated system causes the action. For example, when an email bounces, an automation email is sent, and more 
  10. Click the "Add" button when finished.

How to create a Custom webhook under Developer Settings

  1. Click "Settings" then click "Developer."
  2. Click the "Manage Webhooks" button.
  3. Click the "Add" button.
  4. Select “Custom” for the webhook type.
  5. Type the name of the webhook into the "Name" field.
  6. Type the URL of the outside source that will receive the webhook data.
  7. Choose the event that will trigger the webhook to send data to your outside source. Note that you can select more than one event.
  8. Click the “Add” button.

How webhook data is received

The data you receive will be sent as a POST parameter to your URL. View a list of fields that will be sent in your webhook. 

ActiveCampaign guarantees at-least-once delivery of webhooks. This means that we will sometimes send a webhook more than once for a single event.

Valid characters and limits for webhooks

You can use alphanumeric characters, plus the following special characters in your webhook URL:
"$-_.+!*' (),"

There are no character limits on the number of characters included in a note or other field in a webhook.

Testing your webhook

To test your webhook, click the "Send Sample Data" button located on the Settings > Developer > Webhooks page in your ActiveCampaign account. Once clicked, we'll send test data to the URL specified in your webhook URL bar.

Was this article helpful?
6 out of 13 found this helpful

Have more questions? Submit a request

Start free trial