crm
ActiveCampaign CLI for Headless Automation
Use the ActiveCampaign CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
15 functions 7 read 8 write API key auth
ActiveCampaign CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The ActiveCampaign CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# ActiveCampaign CLI for Headless Automation
kosmokrator integrations:configure activecampaign --set api_key="$ACTIVECAMPAIGN_API_KEY" --set account_name="$ACTIVECAMPAIGN_ACCOUNT_NAME" --enable --read allow --write ask --json
kosmo integrations:call activecampaign.activecampaign_list_contacts '{"limit":1,"offset":1,"search":"example_search","filters":"example_filters"}' --json Discovery Before Execution
Agents and scripts can inspect ActiveCampaign docs and schemas before choosing a function.
kosmo integrations:docs activecampaign --json
kosmo integrations:docs activecampaign.activecampaign_list_contacts --json
kosmo integrations:schema activecampaign.activecampaign_list_contacts --json
kosmo integrations:search "ActiveCampaign" --json
kosmo integrations:list --json Useful ActiveCampaign CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
activecampaign.activecampaign_list_contacts | Read | limit, offset, search, filters | List contacts from ActiveCampaign. Supports pagination, search by email or name, and filtering by list, status, and other criteria. |
activecampaign.activecampaign_get_contact | Read | contact_id | Get details of a specific ActiveCampaign contact by ID, including email, name, phone, and custom fields. |
activecampaign.activecampaign_create_contact | Write | email, firstName, lastName, phone | Create a new contact in ActiveCampaign. Requires an email address; firstName, lastName, and phone are optional. |
activecampaign.activecampaign_update_contact | Write | contact_id, email, firstName, lastName, phone, fields | Update an existing contact in ActiveCampaign. Provide the contact ID and any fields to update (email, firstName, lastName, phone, or custom fields). |
activecampaign.activecampaign_delete_contact | Write | contact_id | Delete a contact from ActiveCampaign. This action is permanent and cannot be undone. |
activecampaign.activecampaign_list_lists | Read | limit, offset | List all contact lists in ActiveCampaign. Returns list IDs, names, and subscriber counts. |
activecampaign.activecampaign_get_list | Read | list_id | Get details of a specific ActiveCampaign list by ID, including name, subscriber count, and settings. |
activecampaign.activecampaign_add_contact_to_list | Write | contact_id, list_id | Subscribe a contact to a list in ActiveCampaign. The contact will be added to the specified list. |
activecampaign.activecampaign_remove_contact_from_list | Write | contact_id, list_id | Unsubscribe a contact from a list in ActiveCampaign. The contact will be removed from the specified list. |
activecampaign.activecampaign_list_deals | Read | limit, offset, search, filters | List deals from ActiveCampaign. Supports pagination, search, and filtering by pipeline, stage, status, or owner. |
activecampaign.activecampaign_get_deal | Read | deal_id | Get details of a specific ActiveCampaign deal by ID, including title, value, stage, pipeline, and associated contact. |
activecampaign.activecampaign_create_deal | Write | title, value, contact_id, stage, pipeline | Create a new deal in ActiveCampaign. Requires a title, value, contact ID, and stage. Optionally specify a pipeline. |
activecampaign.activecampaign_update_deal | Write | deal_id, title, value, stage, pipeline, status, owner, percent, fields | Update an existing deal in ActiveCampaign. Provide the deal ID and any fields to update (title, value, stage, pipeline, status, etc.). |
activecampaign.activecampaign_list_automations | Read | limit, offset | List all automations in ActiveCampaign. Returns automation IDs, names, status, and trigger counts. |
activecampaign.activecampaign_create_note | Write | contact_id, note | Create a note attached to a contact in ActiveCampaign. Provide the contact ID and note text. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.