ActiveCampaign

Read and write the core CRM objects in ActiveCampaign through its v3 REST API. The tool lists and creates contacts and deals, the building blocks of ActiveCampaign's automation pipelines.

It uses the Python standard library only (no third-party packages) and returns the raw API response so you always see exactly what ActiveCampaign returned.

What it does

Each call publishes:

• status — the HTTP status code (e.g. 200, 201, 422).
• result — the response body as a JSON string.

Base URL and authentication

ActiveCampaign's API is account-specific. The base URL is:

https://<account>.api-us1.com/api/3

where <account> is your account subdomain. Authentication is a single API key sent in the Api-Token HTTP header — there is no OAuth or JWT step.

apiKey setup

1. Log in to ActiveCampaign.
2. Go to Settings > Developer.
3. Copy the API URL (the host gives you <account> — e.g. for https://acme.api-us1.com the account is acme) and the API Key.
4. Pass the account subdomain as account and the key as apiKey.

Inputs

Examples

List contacts matching an email:

{
  "account": "acme",
  "apiKey": "YOUR_API_KEY",
  "operation": "list_contacts",
  "email": "[email protected]"
}

Create a contact:

{
  "account": "acme",
  "apiKey": "YOUR_API_KEY",
  "operation": "create_contact",
  "email": "[email protected]",
  "firstName": "John",
  "lastName": "Doe",
  "phone": "7223224241"
}

List deals:

{
  "account": "acme",
  "apiKey": "YOUR_API_KEY",
  "operation": "list_deals",
  "limit": "50"
}

Create a deal (value is in cents — 15000 = $150.00):

{
  "account": "acme",
  "apiKey": "YOUR_API_KEY",
  "operation": "create_deal",
  "title": "Acme renewal",
  "value": "15000",
  "currency": "usd",
  "group": "1",
  "stage": "1",
  "owner": "1",
  "contact": "12"
}

Notes

• Deal value is in cents and currency should match your pipeline's configured currency.
• group (pipeline), stage, and owner are numeric ids you can discover via ActiveCampaign's /api/3/dealGroups, /api/3/dealStages, and /api/3/users endpoints (not exposed by this tool — look them up in the UI or API once).
• The tool never raises on a 4xx/5xx; it returns ActiveCampaign's status and error body so validation failures (e.g. 422) are visible in result.

Grounded in the official API reference: https://developers.activecampaign.com/reference/overview

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

• error
• result
• status

Input Properties

Every property this tool accepts, from its own tool.iml.