# Kit (ConvertKit)

Manage Kit (ConvertKit): subscribers, tags, sequences, forms, broadcasts. Exposes **24 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `convertkit_me` | Get the authenticated creator's account info - GET /me. |
| `convertkit_list_subscribers` | List all subscribers - GET /subscribers. |
| `convertkit_get_subscriber` | Get one subscriber by UUID - GET /subscribers/{id}. |
| `convertkit_create_subscriber` | Add a new subscriber - POST /subscribers. |
| `convertkit_update_subscriber` | Update an existing subscriber - PATCH /subscribers/{id}. |
| `convertkit_delete_subscriber` | Delete a subscriber - DELETE /subscribers/{id}. |
| `convertkit_list_forms` | List all opt-in forms - GET /forms. |
| `convertkit_get_form` | Get one form's details - GET /forms/{id}. |
| `convertkit_list_tags` | List all tags - GET /tags. |
| `convertkit_create_tag` | Create a new tag - POST /tags. |
| `convertkit_delete_tag` | Delete a tag - DELETE /tags/{id}. |
| `convertkit_list_sequences` | List all sequences (email automation courses) - GET /sequences. |
| `convertkit_get_sequence` | Get one sequence's details - GET /sequences/{id}. |
| `convertkit_sequence_subscribe` | Subscribe a person to a sequence (automation course) - POST /sequences/{id}/subscribe. |
| `convertkit_sequence_unsubscribe` | Unsubscribe a person from a sequence - DELETE /sequences/{id}/subscribe. |
| `convertkit_list_custom_fields` | List all custom fields - GET /custom_fields. |
| `convertkit_list_broadcasts` | List broadcasts (email newsletters) - GET /broadcasts. |
| `convertkit_get_broadcast` | Get one broadcast's full details - GET /broadcasts/{id}. |
| `convertkit_create_broadcast` | Create a new broadcast (draft email) - POST /broadcasts. |
| `convertkit_update_broadcast` | Update a broadcast (draft only) - PATCH /broadcasts/{id}. |
| `convertkit_send_broadcast` | Send a broadcast to all subscribers - POST /broadcasts/{id}/publish. |
| `convertkit_list_webhooks` | List all webhooks - GET /webhooks. |
| `convertkit_create_webhook` | Create a webhook - POST /webhooks. |
| `convertkit_delete_webhook` | Delete a webhook - DELETE /webhooks/{id}. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`CONVERTKIT_API_KEY`** - Kit - Settings - Developer - API keys (v4). (https://app.kit.com/account_settings/developer_settings)

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `CONVERTKIT_API_KEY` | Kit - Settings - Developer - API keys (v4). |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope - regenerate it.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Kit (ConvertKit) API documentation](https://developers.kit.com/reference)