ActiveCampaign

Overview

Signals reads contacts, deals and automation activity from ActiveCampaign on a schedule and sends the fields you mapped on to your ad platforms.

Two ActiveCampaign modules are supported: Contacts and Deals. Contacts holds the details destinations match on, and Deals holds the outcome, such as a deal reaching won.

Supported destinations

Destinations supported by ActiveCampaign

Category	Supported
Offline Conversions	Google Offline Conversions API Google Store Sales LinkedIn Offline Conversions API Meta Offline Conversions API OpenAI Offline Conversions API Snapchat Offline Conversions API TikTok Offline Events API
Lead Conversions	Google Enhanced Conversions for Leads LinkedIn Leads Conversions API Meta Conversions API for CRM Snapchat Leads Conversions API TikTok CRM Integrations
Custom Audience	Google Customer Match Meta Custom Audience Snapchat Custom Audience TikTok Custom Audience

Prerequisites

• An ActiveCampaign account holding the records you intend to sync, in the module you intend to read: Contacts or Deals. The fields you intend to map must already exist.
• Administrator access to your ActiveCampaign account, on a plan that includes API access. You need it to generate the API credentials Signals connects with and to grant read access to the records you map.
• A single-select field on the module you sync holding each record’s stage, such as New, Contacted, Qualified, Won or Lost. Each value maps to a conversion event, so a record left on a stale stage reports the wrong one.

Authentication

In Studio, open Sources, find the CRM category, and click the ActiveCampaign tile. This connector authenticates with credentials you add manually. Enter the following, then continue.

Field	Where to find it
ActiveCampaign API URL	The developer settings screen in ActiveCampaign.
ActiveCampaign API Key	The same screen as the API URL.

Caution

The API key grants access to the whole ActiveCampaign account, not only the records Signals reads. Enter it on the Datahash connection screen only, and regenerate it in ActiveCampaign if it has been pasted anywhere else.

Configuration

Instance Setup

Select the Integration Type based on where the data needs to be sent. The options are Offline Events, Audience, Meta CAPI CRM, Google Leads, TikTok Leads, Snapchat Leads and LinkedIn Leads. The choice decides which fields you are asked to map and which destinations the connection can feed, so settle it first. Then choose the ActiveCampaign module Signals reads from, one of Contacts or Deals, and give the instance a name. Only modules the connection can see will appear in the list.

Field mapping

Map your ActiveCampaign fields onto the schema Signals expects. Each field is a dropdown of your own fields, so nothing has to be renamed in the CRM. What you are asked to map depends on the integration type.

Group	Fields
Configuration	Event name, event time, last modified date, lead lifecycle stage.
Personal information	Email, phone, first name, last name, city, state, country, postcode, gender, date of birth, Facebook click ID, Google click ID, OpenAI identifier, source URL.
Product	Total value, currency, product type, name, category, ID, brand, price, quantity, transaction ID, number of items.

Test connection

Click Test Connection before finishing. It checks both that the credentials still work and that the mapped fields actually contain data, so a mapping pointed at an empty field fails here rather than silently later.

Manage instance

One instance is configured for one module. To read another module, configure it on a new instance from the Manage existing instance table. To change an existing one, open it from the Manage existing instance table, click the edit option in the menu to the top right, update the fields and click Finish.

Data & identifiers

Only the fields you map are read. Personal identifiers are normalized and SHA-256 hashed before they are sent to any destination.

Email, phone, name and location are what destinations match on. Value, currency and product fields describe the conversion rather than the person, so they do not affect match rates.

Best practices

• If you map a platform lead ID such as the Meta Lead ID, keep that field as text. A numeric field truncates long IDs, which is the most common cause of lead conversions never matching.
• Ensure the module holds personal information such as email address and phone number. Destinations weight these highest, so records without them match at a much lower rate.
• Maintaining consistent formatting in ActiveCampaign helps match rates: email addresses in lowercase, phone numbers in E.164 format, and no trailing spaces.

Troubleshooting & FAQ

Validate Credentials fails. Check the API URL and the API key come from the same ActiveCampaign account. Both are shown together on the developer settings screen, so taking one from a different account is the usual cause.

Contacts arrive but deals do not. One instance reads one module. Add a second instance for Deals from the Manage existing instance table.

A record changed in ActiveCampaign but nothing was sent. Signals reads on a schedule, so the change is picked up on the next read rather than immediately. If it is still missing after that, check the last modified date field is mapped, since that is what marks the record as changed.

A deal reached won but the destination shows no outcome. The deal stage field is not mapped, so there is nothing telling the destination the result. Map it and re-check.

Lead conversions never match at the platform. The field holding the platform lead ID is numeric, so long IDs are truncated. Change it to a text field and re-sync.