← Back to Skills Marketplace
byungkyu

active-campaign

by byungkyu · GitHub ↗ · v1.2.6 · MIT-0
cross-platform ✓ Security Clean
6100
Downloads
4
Stars
0
Active Installs
18
Versions
Install in OpenClaw
/install active-campaign
Description
ActiveCampaign API integration with managed OAuth. Marketing automation, CRM, contacts, deals, email campaigns, automations, tags, lists, users, accounts, custom fields, notes, and webhooks. All write operations require explicit user approval. Webhook creation sends account event data to external URLs — confirm the destination before creating. User and account management are administrative operations that affect shared resources. Use this skill when users want to manage contacts, deals, tags, lists, automations, campaigns, or account settings in ActiveCampaign. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key. Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. Every call is authenticated as the user's connection and reaches only what that connection's authorization allows, which the provider enforces on every request; the endpoints documented here are the ones this skill uses, and any other endpoint of this app needs the user to ask for it by name. Default to read and list calls, and confirm every write or new connection with the user. This file also documents the three constructs that turn an ActiveCampaign connection into automation, in the order they are used: the connection (the first step), a hosted function that runs an ActiveCampaign action through the Maton SDK, and a trigger that calls that function on a schedule or on an event. Those sections are the platform's own reference text, shared with the api-gateway skill, with ActiveCampaign examples; they add no ActiveCampaign capability - ActiveCampaign is not an event source, a trigger cannot read ActiveCampaign data, and the files under `references/<source>/triggers.md` are the platform's event catalogues for the sources Maton offers (time, Calendly, GitHub, Gmail, HubSpot, Linear, Notion, Slack, Stripe).
Usage Guidance
Install only if you intend to let Maton access your ActiveCampaign account. Review the OAuth scopes, confirm the exact account/connection before writes, and be especially careful with webhooks, trigger destinations, hosted functions, and account or user administration because those can have persistent business-data effects.
Capability Assessment
✓ Credentials
The skill uses network API calls through Maton and does not direct broad local file access, credential extraction, or unrelated data collection; raw HTTP API-key use is limited to environments without the CLI and includes handling cautions.
ℹ Install Mechanism
Installation uses a pinned Maton CLI via npm or Homebrew and requires network access and Maton authentication; this is disclosed and proportionate for the integration.
✓ Instruction Scope
Instructions repeatedly default to read/list operations, require explicit approval for connection creation and all writes, warn about webhooks and persistent forwarding, and scope non-ActiveCampaign trigger references to user-requested automation only.
ℹ Persistence & Privilege
OAuth tokens are stored in the OS credential store, and user-created functions, triggers, destinations, webhooks, and connections can persist until deleted; the artifact discloses this and requires explicit approval and cleanup guidance.
ℹ Purpose & Capability
The skill manages ActiveCampaign contacts, deals, lists, tags, automations, campaigns, users, accounts, custom fields, notes, webhooks, and optional Maton functions/triggers; these capabilities match the stated integration purpose.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install active-campaign
  3. After installation, invoke the skill by name or use /active-campaign
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.6
Simplify the login instructions to the code flow (maton login prints a link; finish with maton login --code <CODE>), drop the API Key subsection, and pin the Maton CLI install to 0.4.0.
v1.2.5
Switch the login instructions to the device flow (maton login prints a link and a user code; the --oauth flag is gone) and pin the Maton CLI install to 0.3.5.
v1.2.4
Pin the Maton CLI install to 0.3.4, the current release.
v1.2.3
Add this skill's own trigger policy to the shared Triggers section: the only destination it sets up is its own hosted function inside the platform, it does not forward events to third-party hosts, and it does not use event watch --exec; each trigger reference now also says this skill configures no trigger from that source on its own.
v1.2.2
Bring the skill to the current api-gateway baseline and tell the connection-to-function-to-trigger story: the shared Functions and Triggers sections open with an example for this app (a hosted function that performs one action for it through the Maton SDK, and the trigger that runs it - its own event source where it has one, otherwise a time schedule), the description says these constructs turn the connection into automation and add no capability of their own, the passthrough is described by its enforced boundary, CLI and SDK installs are pinned to 0.3.1, absolute API URLs are placeholders, and multipart uploads use mktemp.
v1.2.1
Reword the webhook warning and separate CLI vs SDK credential guidance to address SkillSpector findings (P3/E1 exfiltration-phrasing false positive, SDI-4 auth inconsistency)
v1.2.0
Appendix drops the raw curl example; SkillSpector 2.11 static findings addressed across the reference; HTTP blocks replaced with maton api
v1.1.1
CLI-first rewrite: maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.1.0
CLI-first rewrite: maton CLI with OAuth login is the documented path, every example is a maton command, raw HTTP moved to an appendix
v1.0.8
- Expanded supported API resources to include automations, users, accounts, custom fields, notes, and webhooks. - Updated description and security section to highlight that webhooks and user/account management are advanced/admin actions and require confirmation. - Clarified that all write operations must get explicit user approval. - Removed redundant documentation file (skill-card.md), consolidating information into SKILL.md.
v1.0.7
- Updated all API and connection management URLs from gateway.maton.ai and ctrl.maton.ai to api.maton.ai for consistency. - Clarified connection header usage: always specify Maton-Connection when multiple accounts exist. - Added a new "Security & Permissions" section, emphasizing user confirmation for all write operations. - Removed obsolete file: LICENSE.txt.
v1.0.6
- Fixed documentation typo: the base URL instruction now correctly refers to the "ActiveCampaign API" (not Airtable). - No functional or interface changes; this is a documentation-only update.
v1.0.5
- Added the "homepage" field to the skill metadata, linking to https://maton.ai. - No other functional changes or file updates included in this version.
v1.0.4
- Updated base URL instructions to use `/active-campaign/{native-api-path}` and clarified endpoint substitution. - Added details specifying that the gateway proxies ActiveCampaign endpoints and injects the OAuth token automatically. - Provided example and explanation for replacing `{native-api-path}` with the actual API endpoint. - No changes to functionality or code—documentation improvements only.
v1.0.3
- Added a new metadata section to SKILL.md specifying required environment variable MATON_API_KEY and an emoji identifier. - No changes to functionality or user instructions. - Version and author fields remain unchanged.
v1.0.2
- No file changes detected in this release. - Documentation and functionality remain unchanged from the previous version.
v1.0.1
No changes detected in this release. - Version number updated to 1.0.1. - No differences found between previous and current files.
v1.0.0
Initial release: ActiveCampaign API integration with managed OAuth and Maton API key. - Supports management of contacts, deals, tags, lists, automations, and email campaigns via proxy gateway. - Includes sample code and API endpoint documentation for listing, creating, updating, and deleting key resources. - Secure authentication with Maton API key and managed OAuth connections. - Instructions provided for managing and specifying OAuth connections. - Designed for marketing automation and CRM workflows using ActiveCampaign.
Metadata
Slug active-campaign
Version 1.2.6
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 18
Frequently Asked Questions

What is active-campaign?

ActiveCampaign API integration with managed OAuth. Marketing automation, CRM, contacts, deals, email campaigns, automations, tags, lists, users, accounts, custom fields, notes, and webhooks. All write operations require explicit user approval. Webhook creation sends account event data to external URLs — confirm the destination before creating. User and account management are administrative operations that affect shared resources. Use this skill when users want to manage contacts, deals, tags, lists, automations, campaigns, or account settings in ActiveCampaign. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key. Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. Every call is authenticated as the user's connection and reaches only what that connection's authorization allows, which the provider enforces on every request; the endpoints documented here are the ones this skill uses, and any other endpoint of this app needs the user to ask for it by name. Default to read and list calls, and confirm every write or new connection with the user. This file also documents the three constructs that turn an ActiveCampaign connection into automation, in the order they are used: the connection (the first step), a hosted function that runs an ActiveCampaign action through the Maton SDK, and a trigger that calls that function on a schedule or on an event. Those sections are the platform's own reference text, shared with the api-gateway skill, with ActiveCampaign examples; they add no ActiveCampaign capability - ActiveCampaign is not an event source, a trigger cannot read ActiveCampaign data, and the files under `references/<source>/triggers.md` are the platform's event catalogues for the sources Maton offers (time, Calendly, GitHub, Gmail, HubSpot, Linear, Notion, Slack, Stripe). It is an AI Agent Skill for Claude Code / OpenClaw, with 6100 downloads so far.

How do I install active-campaign?

Run "/install active-campaign" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is active-campaign free?

Yes, active-campaign is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does active-campaign support?

active-campaign is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created active-campaign?

It is built and maintained by byungkyu (@byungkyu); the current version is v1.2.6.

💬 Comments