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
```...