Prerequisites
Before connecting, make sure you have:- An ActiveCampaign account (API access is available on all plans, including Lite)
- Your ActiveCampaign API URL and API Key (found under Settings → Developer in ActiveCampaign)
- Admin access in your Stairoids workspace
Connect ActiveCampaign
Copy your API credentials from ActiveCampaign
In ActiveCampaign, go to Settings → Developer. Copy both the API URL (e.g.,
https://youraccountname.api-us1.com) and the API Key.Open Integration Settings in Stairoids
Navigate to Settings → Integrations and click Add Integration.
Select ActiveCampaign
Choose ActiveCampaign from the integration catalog. Enter your API URL and API Key, then click Connect.
Select campaign events to track
Stairoids will load a list of your ActiveCampaign campaigns and lists. Toggle on the events you want to convert into signals. You can filter by campaign or list to avoid importing events from unrelated nurture sequences.
Supported signal types
| Signal type | Trigger | Key properties |
|---|---|---|
email_open | Contact opens an email | contact_email, campaign_id, campaign_name, opened_at |
email_click | Contact clicks a tracked link | contact_email, link_url, campaign_id, clicked_at |
email_reply | Contact replies to a campaign email | contact_email, campaign_id, reply_subject, replied_at |
form_submit | Contact submits an ActiveCampaign form | contact_email, form_id, form_name, submitted_at |
list_subscribe | Contact subscribes to a list | contact_email, list_id, list_name, subscribed_at |
list_unsubscribe | Contact unsubscribes from a list | contact_email, list_id, list_name, unsubscribed_at |
Contact matching
When an ActiveCampaign signal arrives, Stairoids matches it to an existing contact using thecontact_email field. If a contact with that email address exists in your Stairoids workspace, the signal is attached to them automatically. If no match is found, Stairoids creates a new contact record using the email address and any additional fields provided by the ActiveCampaign event (first name, last name, phone if present).
Supported outgoing actions
When a Stairoids automation targets ActiveCampaign, it can perform the following actions:- Add contact to list — subscribe a contact to a specific ActiveCampaign list
- Add tag — apply a tag to a contact record
- Send campaign — trigger a one-time email campaign send to a contact
- Update custom field — write a value to any ActiveCampaign contact custom field
Troubleshooting
Events not flowing into Stairoids
Events not flowing into Stairoids
- Go to Settings → Integrations → ActiveCampaign and confirm the connection status is Active.
- Check ActiveCampaign’s Settings → Developer → Event Tracking to confirm Stairoids’ webhooks are registered. If they’re missing, disconnect and reconnect the integration.
- Verify that the relevant event types (e.g.,
email_open,email_click) are toggled on in the Stairoids ActiveCampaign configuration panel. - Confirm the campaigns you’re monitoring are in Active or Sent status in ActiveCampaign. Paused or draft campaigns do not fire engagement events.
- Some ActiveCampaign plans throttle webhook delivery under high volume. If you’re running large broadcast campaigns, allow a few extra minutes for events to arrive.
Contact not matched in Stairoids
Contact not matched in Stairoids
- Confirm the ActiveCampaign event includes a valid email address. Events from contacts who opted out of email tracking or whose email was masked will not contain a usable address.
- Check whether the contact already exists in Stairoids under a different email address. If so, add the ActiveCampaign email as a secondary email on the Stairoids contact record.
- If automatic contact creation is disabled in your workspace settings (Settings → Contacts → Auto-create from signals), unmatched signals will queue without creating new contacts. Enable auto-creation or manually create the contact and the queued signals will attach retroactively.