- Documentation
ActiveCampaign integration
Sync contacts, manage lists and deals, and react to subscriber lifecycle events across your clients' ActiveCampaign accounts.
What it does
The ActiveCampaign integration lets your agency run a client's marketing automation, sales pipeline, and email campaigns without leaving TaskJuice. Connect a client's ActiveCampaign account once and you can create or update contacts, look up a single contact, search contacts by email or free text, subscribe contacts to lists, create campaigns, and create or fetch deals in the CRM. Five webhook triggers turn ActiveCampaign activity into workflow runs covering contact subscribe and unsubscribe, contact create and update, and list changes.
Connect an ActiveCampaign account
- Open your workspace in TaskJuice and navigate to Connections.
- Choose ActiveCampaign and click Connect.
- Sign in to the ActiveCampaign account you want to manage on behalf of your client, open Settings, and choose Developer.
- Copy the account name (the prefix before
.api-us1.comin the API URL) and the API key. - Paste both values into TaskJuice and save. The connection is ready to use in any workflow.
To revoke access, sign in to ActiveCampaign, open Settings, choose Developer, and regenerate the API key. TaskJuice surfaces the resulting 401 on the next workflow run so you can rotate the credential.
Triggers
activecampaign/contact-subscribedfires when a contact subscribes to a list, with the contact payload and the target list ID attached.activecampaign/contact-unsubscribedfires when a contact unsubscribes from a list, with the unsubscribe reason and list ID attached.activecampaign/contact-addedfires when a new contact is created in the connected account.activecampaign/contact-updatedfires when an existing contact is updated, including the changed field names ActiveCampaign reports.activecampaign/list-updatedfires when a list is created or its metadata changes.
Actions
activecampaign/create-contactcreates a new contact with email, name, phone, and an optional array of custom field values.activecampaign/update-contactupdates an existing contact by its numeric ID.activecampaign/get-contactfetches a single contact by ID, with its custom field values.activecampaign/list-contactslists contacts with optional email or free-text search, paginated vialimitandoffset.activecampaign/add-contact-to-listsubscribes a contact to a list (set status to 2 to unsubscribe).activecampaign/create-campaigncreates a single-send email campaign with sender, subject, HTML and text bodies, and list assignments.activecampaign/create-dealcreates a deal in the CRM with title, value, currency, contact, owner, pipeline, and stage.activecampaign/get-dealretrieves a single deal by its numeric ID.
Known limitations
- ActiveCampaign API keys are scoped to a single account subdomain. Each client needs its own connection, with its own account name and API key.
- ActiveCampaign enforces a per-account rate-limit budget on the v3 API and returns
429with aRetry-Afterheader when exceeded. The action engine retries429responses with backoff; very high-volume cycles should pace work with a downstream throttle. - Webhooks are signed with HMAC-SHA256 over the raw request body and the hex digest is sent in the
X-AC-Signatureheader. Use the same signing secret you configured in the ActiveCampaign webhook when you register the trigger, and the platform verifies every inbound POST before activating the workflow. - Campaign creation produces a draft campaign in ActiveCampaign. Sending the campaign is a separate step in the ActiveCampaign UI; the API supports send scheduling through additional fields not exposed in this integration's initial action set.