kit

What This Skill Does

The Kit (formerly ConvertKit) skill provides a secure, streamlined interface for OpenClaw AI agents to interact with your email marketing platform. By utilizing managed OAuth authentication through the Maton gateway, this skill abstracts away the complexities of token handling and API headers. It allows your agent to perform administrative and marketing tasks such as managing subscribers, organizing audiences via tags, deploying email sequences, and broadcasting updates. The skill acts as a proxy, directing requests to the native Kit API while ensuring your credentials remain secure and authorized through the Maton controller.

Installation

To integrate this skill into your environment, use the command: clawhub install openclaw/skills/skills/byungkyu/kit. After installation, ensure you have set your Maton API key as an environment variable by executing export MATON_API_KEY="YOUR_API_KEY". Before performing API operations, you must establish an active connection via the ctrl.maton.ai endpoint. Use the provided Python snippet to create a connection, then navigate to the returned URL in your web browser to complete the OAuth handshake with your Kit account.

Use Cases

This skill is perfect for automating routine email marketing workflows. Common use cases include: segmenting your audience based on specific user behavior or interactions, bulk-adding new leads from external forms, cleaning your subscriber list by removing inactive users based on activity data, and scheduling time-sensitive broadcast emails. Developers can also use this to synchronize custom fields between external databases and Kit, ensuring marketing efforts remain aligned with current user profiles.

Example Prompts

1. "Find all subscribers with the tag 'newsletter-sub' and move them into the 'premium-member' segment."
2. "Get the latest stats for my recent broadcast and summarize the open rate and click-through rate for me."
3. "Create a new subscriber named Jane Doe with the email '[email protected]' and apply the tag 'onboarding'."

Tips & Limitations

Always verify your connection status using the list connections command if your agent encounters authentication errors. The skill proxies directly to the native Kit API, meaning you should consult the official Kit documentation for specific endpoints and payload structures. Be aware that rate limits defined by the Kit API still apply. Avoid running high-frequency batch operations without implementing necessary sleep or pagination logic to maintain API stability.