convertkit

# ✉️ 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 ```bash # List subscribers python3 {baseDir}/scripts/convertkit.py subscribers --limit 50 --sort created_at ``` ```bash # Get subscriber details python3 {baseDir}/scripts/convertkit.py subscriber-get 12345 ``` ```bash # Add a subscriber python3 {baseDir}/scripts/convertkit.py subscriber-add --email "user@example.com" --first-name "Jane" ``` ```bash # Search by email python3 {baseDir}/scripts/convertkit.py subscriber-search "user@example.com" ``` ## Commands ### `subscribers` List subscribers. ```bash python3 {baseDir}/scripts/convertkit.py subscribers --limit 50 --sort created_at ``` ### `subscriber-get` Get subscriber details. ```bash python3 {baseDir}/scripts/convertkit.py subscriber-get 12345 ``` ### `subscriber-add` Add a subscriber. ```bash python3 {baseDir}/scripts/convertkit.py subscriber-add --email "user@example.com" --first-name "Jane" ``` ### `subscriber-search` Search by email. ```bash python3 {baseDir}/scripts/convertkit.py subscriber-search "user@example.com" ``` ### `tags` List all tags. ```bash python3 {baseDir}/scripts/convertkit.py tags ``` ### `tag-create` Create a tag. ```bash python3 {baseDir}/scripts/convertkit.py tag-create "VIP Customer" ``` ### `tag-apply` Tag a subscriber. ```bash python3 {baseDir}/scripts/convertkit.py tag-apply --tag 123 --email user@example.com ``` ### `tag-remove` Remove tag. ```bash python3 {baseDir}/scripts/convertkit.py tag-remove --tag 123 --email user@example.com ``` ### `forms` List forms. ```bash python3 {baseDir}/scripts/convertkit.py forms ``` ### `form-subscribers` List form subscribers. ```bash python3 {baseDir}/scripts/convertkit.py form-subscribers 456 ``` ### `sequences` List sequences. ```bash python3 {baseDir}/scripts/convertkit.py sequences ``` ### `sequence-subscribers` List sequence subscribers. ```bash python3 {baseDir}/scripts/convertkit.py sequence-subscribers 789 ``` ### `broadcasts` List broadcasts. ```bash python3 {baseDir}/scripts/convertkit.py broadcasts --limit 20 ``` ### `broadcast-create` Create a broadcast. ```bash python3 {baseDir}/scripts/convertkit.py broadcast-create '{"subject":"Weekly Update","content":"<p>Hello!</p>"}' ``` ### `broadcast-send` Send a broadcast. ```bash python3 {baseDir}/scripts/convertkit.py broadcast-send 12345 ``` ## Output Format All commands output JSON by default. Add `--human` for readable formatted output. ```bash # 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](https://www.linkedin.com/in/mohammad-ali-abidi) | [agxntsix.ai](https://www.agxntsix.ai) [YouTube](https://youtube.com/@aiwithabidi) | [GitHub](https://github.com/aiwithabidi) Part of the **AgxntSix Skill Suite** for OpenClaw agents. 📅 **Need help setting up OpenClaw for your business?** [Book a free consultation](https://cal.com/agxntsix/abidi-openclaw)