✉️ ConvertKit
ConvertKit (Kit) creator marketing — manage subscribers, forms, sequences, broadcasts, tags, and automations via the ConvertKit API.
Features
- Subscriber management — add, tag, search, and segment
- Form management — list forms and their subscribers
- Email sequences — create and manage drip campaigns
- Broadcasts — create and send one-time emails
- Tag operations — create, apply, remove subscriber tags
- Automation rules — view automation workflows
- Custom fields — manage subscriber custom fields
- Subscriber search — find by email or custom attributes
- Analytics — subscriber growth, form conversions, sequence stats
- Bulk operations — tag/untag multiple subscribers
Requirements
| Variable | Required | Description |
|---|---|---|
CONVERTKIT_API_KEY | ✅ | API key/token for ConvertKit |
Quick Start
# List subscribers
python3 {baseDir}/scripts/convertkit.py subscribers --limit 50 --sort created_at
# Get subscriber details
python3 {baseDir}/scripts/convertkit.py subscriber-get 12345
# Add a subscriber
python3 {baseDir}/scripts/convertkit.py subscriber-add --email "user@example.com" --first-name "Jane"
# Search by email
python3 {baseDir}/scripts/convertkit.py subscriber-search "user@example.com"
Commands
subscribers
List subscribers.
python3 {baseDir}/scripts/convertkit.py subscribers --limit 50 --sort created_at
subscriber-get
Get subscriber details.
python3 {baseDir}/scripts/convertkit.py subscriber-get 12345
subscriber-add
Add a subscriber.
python3 {baseDir}/scripts/convertkit.py subscriber-add --email "user@example.com" --first-name "Jane"
subscriber-search
Search by email.
python3 {baseDir}/scripts/convertkit.py subscriber-search "user@example.com"
tags
List all tags.
python3 {baseDir}/scripts/convertkit.py tags
tag-create
Create a tag.
python3 {baseDir}/scripts/convertkit.py tag-create "VIP Customer"
tag-apply
Tag a subscriber.
python3 {baseDir}/scripts/convertkit.py tag-apply --tag 123 --email user@example.com
tag-remove
Remove tag.
python3 {baseDir}/scripts/convertkit.py tag-remove --tag 123 --email user@example.com
forms
List forms.
python3 {baseDir}/scripts/convertkit.py forms
form-subscribers
List form subscribers.
python3 {baseDir}/scripts/convertkit.py form-subscribers 456
sequences
List sequences.
python3 {baseDir}/scripts/convertkit.py sequences
sequence-subscribers
List sequence subscribers.
python3 {baseDir}/scripts/convertkit.py sequence-subscribers 789
broadcasts
List broadcasts.
python3 {baseDir}/scripts/convertkit.py broadcasts --limit 20
broadcast-create
Create a broadcast.
python3 {baseDir}/scripts/convertkit.py broadcast-create '{"subject":"Weekly Update","content":"<p>Hello!</p>"}'
broadcast-send
Send a broadcast.
python3 {baseDir}/scripts/convertkit.py broadcast-send 12345
Output Format
All commands output JSON by default. Add --human for readable formatted output.
# JSON (default, for programmatic use)
python3 {baseDir}/scripts/convertkit.py subscribers --limit 5
# Human-readable
python3 {baseDir}/scripts/convertkit.py subscribers --limit 5 --human
Script Reference
| Script | Description |
|---|---|
{baseDir}/scripts/convertkit.py | Main CLI — all ConvertKit operations |
Data Policy
This skill never stores data locally. All requests go directly to the ConvertKit API and results are returned to stdout. Your data stays on ConvertKit servers.
Credits
Built by M. Abidi | agxntsix.ai YouTube | GitHub Part of the AgxntSix Skill Suite for OpenClaw agents.
📅 Need help setting up OpenClaw for your business? Book a free consultation