# Kit Formerly ConvertKit Integration via LowCodeAPI
## Overview
Kit is a platform for creating and sending email campaigns.
## Base Endpoint
```
https://api.lowcodeapi.com/convertkit/
```
## Authentication
LowCodeAPI handles authentication automatically. You only need to:
1. **Sign up** at [https://kit.com/](https://kit.com/)
2. **Get your credentials** from [https://app.kit.com/account_settings/advanced_settings](https://app.kit.com/account_settings/advanced_settings)
3. **Connect your account** in LowCodeAPI dashboard
4. **Use your `api_token`** in all requests
The `api_token` is your LowCodeAPI authentication token. LowCodeAPI will automatically:
- Fetch your Kit Formerly ConvertKit credentials
- Apply them to each request
**Auth Type**: API Key
## API Categories
- Marketing Email
## Common Endpoints
### Category: Account
#### Show the current account
**Method**: `GET` | **LowCodeAPI Path**: `/v4/account`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/account?...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key. |
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/account?...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#show-the-current-account](https://developers.kit.com/v4#show-the-current-account)
---
### Category: Broadcasts
#### List broadcasts
**Method**: `GET` | **LowCodeAPI Path**: `/v4/broadcasts`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/broadcasts?...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
| `page` | string | No | The page of results being requested. |
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/broadcasts?...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#list-broadcasts](https://developers.kit.com/v4#list-broadcasts)
---
#### Create a broadcast
**Method**: `POST` | **LowCodeAPI Path**: `/v4/broadcasts`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/broadcasts&api_token={api_token}
```
**Body Parameters**:
| `api_secret` | string | Yes | Your API secret key |
| `content` | string | No | The broadcast's email HTML content |
| `description` | string | No | An internal description of this broadcast |
| `email_address` | string | No | Sending email address leave blank to use your account's default sending email address |
| `email_layout_template` | string | No | Name of the email template to use; leave blank to use your account's default email template |
| `public` | string | No | Specifies whether or not this is a public post |
| `published_at` | string | No | Specifies the time that this post was published (applicable only to public posts) |
| `send_at` | string | No | Time that this broadcast should be sent leave blank to create a draft broadcast. If set to a future time; this is the time that the broadcast will be scheduled to send. |
**Example Request**:
```bash
curl -X POST "https://api.lowcodeapi.com/convertkit/v4/broadcasts?&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"api_secret":"value","content":"value","description":"value"}'
```
**Official Documentation**: [https://developers.kit.com/v4#create-a-broadcast](https://developers.kit.com/v4#create-a-broadcast)
---
#### Retrieve a specific broadcast
**Method**: `GET` | **LowCodeAPI Path**: `/v4/broadcasts/broadcast_id`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/broadcasts/broadcast_id?broadcast_id={broadcast_id}&...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
**Path Parameters**:
| `broadcast_id` | string | broadcast ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/broadcasts/broadcast_id?broadcast_id=VALUE&...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#retrieve-a-specific-broadcast](https://developers.kit.com/v4#retrieve-a-specific-broadcast)
---
#### Get stats
**Method**: `GET` | **LowCodeAPI Path**: `/v4/broadcasts/broadcast_id/stats`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/broadcasts/broadcast_id/stats?broadcast_id={broadcast_id}&...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
**Path Parameters**:
| `broadcast_id` | string | broadcast ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/broadcasts/broadcast_id/stats?broadcast_id=VALUE&...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#get-stats](https://developers.kit.com/v4#get-stats)
---
#### Update a broadcast
**Method**: `PUT` | **LowCodeAPI Path**: `/v4/broadcasts/broadcast_id`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/broadcasts/broadcast_id?broadcast_id={broadcast_id}&api_token={api_token}
```
**Path Parameters**:
| `broadcast_id` | string | broadcast ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Body Parameters**:
| `api_secret` | string | Yes | Your API secret key |
| `content` | string | No | The broadcast's email HTML content |
| `description` | string | No | An internal description of this broadcast |
| `email_address` | string | No | Sending email address; leave blank to use your account's default sending email address |
| `email_layout_template` | string | No | Name of the email template to use; leave blank to use your account's default email template |
| `public` | string | No | Specifies whether or not this is a public post |
| `published_at` | string | No | Specifies the time that this post was published (applicable only to public posts) |
| `send_at` | string | No | Time that this broadcast should be sent; leave blank to create a "draft" broadcast. If set to a future time; this is the time that the broadcast will be scheduled to send. |
**Example Request**:
```bash
curl -X PUT "https://api.lowcodeapi.com/convertkit/v4/broadcasts/broadcast_id?broadcast_id=VALUE&&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"api_secret":"value","content":"value","description":"value"}'
```
**Official Documentation**: [https://developers.kit.com/v4#update-a-broadcast](https://developers.kit.com/v4#update-a-broadcast)
---
#### Destroy a broadcast
**Method**: `DELETE` | **LowCodeAPI Path**: `/v4/broadcasts/broadcast_id`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/broadcasts/broadcast_id?broadcast_id={broadcast_id}&...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
**Path Parameters**:
| `broadcast_id` | string | broadcast ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X DELETE "https://api.lowcodeapi.com/convertkit/v4/broadcasts/broadcast_id?broadcast_id=VALUE&...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#destroy-a-broadcast](https://developers.kit.com/v4#destroy-a-broadcast)
---
### Category: Custom Fields
#### List fields
**Method**: `GET` | **LowCodeAPI Path**: `/v4/custom_fields`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/custom_fields?...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/custom_fields?...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#list-fields](https://developers.kit.com/v4#list-fields)
---
#### Create field
**Method**: `POST` | **LowCodeAPI Path**: `/v4/custom_fields`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/custom_fields&api_token={api_token}
```
**Body Parameters**:
| `label` | string | Yes | The label(s) of the custom field |
| `api_secret` | string | Yes | Your API secret key |
**Example Request**:
```bash
curl -X POST "https://api.lowcodeapi.com/convertkit/v4/custom_fields?&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"label":"value","api_secret":"value"}'
```
**Official Documentation**: [https://developers.kit.com/v4#create-field](https://developers.kit.com/v4#create-field)
---
#### Update field
**Method**: `PUT` | **LowCodeAPI Path**: `/v4/custom_fields/id`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/custom_fields/id?id={id}&api_token={api_token}
```
**Path Parameters**:
| `id` | string | The ID of your custom field |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Body Parameters**:
| `api_secret` | string | Yes | Your API secret key |
| `label` | string | Yes | The label of the custom field |
**Example Request**:
```bash
curl -X PUT "https://api.lowcodeapi.com/convertkit/v4/custom_fields/id?id=VALUE&&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"api_secret":"value","label":"value"}'
```
**Official Documentation**: [https://developers.kit.com/v4#update-field](https://developers.kit.com/v4#update-field)
---
#### Destroy field
**Method**: `DELETE` | **LowCodeAPI Path**: `/v4/custom_fields/id`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/custom_fields/id?id={id}&api_token={api_token}
```
**Path Parameters**:
| `id` | string | The ID of your custom field |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X DELETE "https://api.lowcodeapi.com/convertkit/v4/custom_fields/id?id=VALUE&&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#destroy-field](https://developers.kit.com/v4#destroy-field)
---
### Category: Forms
#### List forms
**Method**: `GET` | **LowCodeAPI Path**: `/v4/forms`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/forms?...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key. |
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/forms?...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#list-forms](https://developers.kit.com/v4#list-forms)
---
#### Add subscriber to a form
**Method**: `POST` | **LowCodeAPI Path**: `/v4/forms/form_id/subscribe`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/forms/form_id/subscribe?form_id={form_id}&api_token={api_token}
```
**Path Parameters**:
| `form_id` | string | Form ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Body Parameters**:
| `api_secret` | string | Yes | Your API secret key |
| `email` | string | Yes | Subscriber email address |
| `first_name` | string | No | Subscriber first name |
| `fields` | string | No | Object of key/value pairs for custom field(s); The custom field(s) must exist before you can use it here |
| `tags` | string | No | Array of tag ids to subscribe to |
**Example Request**:
```bash
curl -X POST "https://api.lowcodeapi.com/convertkit/v4/forms/form_id/subscribe?form_id=VALUE&&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"api_secret":"value","email":"value","first_name":"value"}'
```
**Official Documentation**: [https://developers.kit.com/v4#add-subscriber-to-a-form](https://developers.kit.com/v4#add-subscriber-to-a-form)
---
#### List subscriptions to a form
**Method**: `GET` | **LowCodeAPI Path**: `/v4/forms/form_id/subscriptions`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/forms/form_id/subscriptions?form_id={form_id}&...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
| `sort_order` | string | No | asc to list subscribers added oldest to newest; desc to list subscribers added newest to oldest. asc is the default order. |
| `subscriber_state` | string | No | receive only active subscribers or cancelled subscribers |
| `page` | string | No | the page to retrieve. 50 results are returned per page. |
**Path Parameters**:
| `form_id` | string | Form ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/forms/form_id/subscriptions?form_id=VALUE&...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#list-subscriptions-to-a-form](https://developers.kit.com/v4#list-subscriptions-to-a-form)
---
### Category: Purchases
#### List purchases
**Method**: `GET` | **LowCodeAPI Path**: `/v4/purchases`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/purchases?...&api_token={api_token}
```
**Query Parameters**:
| `page` | string | No | The page of results being requested.Default value is 1.Each page of results will contain up to 50 purchases. |
| `api_secret` | string | Yes | Your API secret key |
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/purchases?...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#list-purchases](https://developers.kit.com/v4#list-purchases)
---
#### Retrieve a specific purchase
**Method**: `GET` | **LowCodeAPI Path**: `/v4/purchases/purchase_id`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/purchases/purchase_id?purchase_id={purchase_id}&...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
**Path Parameters**:
| `purchase_id` | string | A purchase ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/purchases/purchase_id?purchase_id=VALUE&...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#retrieve-a-specific-purchase](https://developers.kit.com/v4#retrieve-a-specific-purchase)
---
#### Create a purchase
**Method**: `POST` | **LowCodeAPI Path**: `/v4/purchases`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/purchases&api_token={api_token}
```
**Body Parameters**:
| `transaction_id` | string | Yes | A unique ID for the purchase |
| `email_address` | string | Yes | The subscriber that the purchase belongs to |
| `currency` | string | Yes | 3 letter currency code (e.g. USD) |
| `products` | string | Yes | Array of purchased products |
| `first_name` | string | No | The first name of the subscriber |
| `subtotal` | string | No | The subtotal of the purchase |
| `tax` | string | No | Tax applied to purchase |
| `shipping` | string | No | Shipping amount applied to purchase |
**Example Request**:
```bash
curl -X POST "https://api.lowcodeapi.com/convertkit/v4/purchases?&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"transaction_id":"value","email_address":"value","currency":"value"}'
```
**Official Documentation**: [https://developers.kit.com/v4#create-a-purchase](https://developers.kit.com/v4#create-a-purchase)
---
### Category: Sequences
#### List sequences
**Method**: `GET` | **LowCodeAPI Path**: `/v4/sequences`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/sequences?...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key. |
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/sequences?...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#list-sequences](https://developers.kit.com/v4#list-sequences)
---
#### Add subscriber to a sequence
**Method**: `POST` | **LowCodeAPI Path**: `/v4/sequences/sequence_id/subscribe`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/sequences/sequence_id/subscribe?sequence_id={sequence_id}&api_token={api_token}
```
**Path Parameters**:
| `sequence_id` | string | Sequence ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Body Parameters**:
| `api_secret` | string | Yes | Your API secret key |
| `email` | string | Yes | Subscriber email address |
| `first_name` | string | No | Subscriber first name |
| `fields` | string | No | Object of key/value pairs for custom field(s); The custom field(s) must exist before you can use it here |
| `tags` | string | No | Array of tag ids to subscribe to |
**Example Request**:
```bash
curl -X POST "https://api.lowcodeapi.com/convertkit/v4/sequences/sequence_id/subscribe?sequence_id=VALUE&&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"api_secret":"value","email":"value","first_name":"value"}'
```
**Official Documentation**: [https://developers.kit.com/v4#add-subscriber-to-a-sequence](https://developers.kit.com/v4#add-subscriber-to-a-sequence)
---
#### List subscriptions to a sequence
**Method**: `GET` | **LowCodeAPI Path**: `/v4/sequences/sequence_id/subscriptions`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/sequences/sequence_id/subscriptions?sequence_id={sequence_id}&...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
| `sort_order` | string | No | asc to list subscribers added oldest to newest; desc to list subscribers added newest to oldest. asc is the default order. |
| `subscriber_state` | string | No | receive only active subscribers or cancelled subscribers |
| `page` | string | No | the page to retrieve. 50 results are returned per page. |
**Path Parameters**:
| `sequence_id` | string | Sequence ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/sequences/sequence_id/subscriptions?sequence_id=VALUE&...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#list-subscriptions-to-a-sequence](https://developers.kit.com/v4#list-subscriptions-to-a-sequence)
---
### Category: Subscribers
#### List subscribers
**Method**: `GET` | **LowCodeAPI Path**: `/v4/subscribers`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/subscribers?...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
| `page` | string | No | Page for paginated results |
| `from` | string | No | Filter subscribers added on or after this date (format yyyy-mm-dd) |
| `to` | string | No | Filter subscribers added on or before this date (format yyyy-mm-dd) |
| `updated_from` | string | No | Filter subscribers who have been updated after this date (format yyyy-mm-dd) |
| `updated_to` | string | No | Filter subscribers who have been updated before this date (format yyyy-mm-dd) |
| `sort_order` | string | No | Sort order for results asc/desc |
| `sort_field` | string | No | Field to sort by (cancelled_at) |
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/subscribers?...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#list-subscribers](https://developers.kit.com/v4#list-subscribers)
---
#### View a single subscriber
**Method**: `GET` | **LowCodeAPI Path**: `/v4/subscribers/subscriber_id`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/subscribers/subscriber_id?subscriber_id={subscriber_id}&...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key. |
**Path Parameters**:
| `subscriber_id` | string | Subscriber ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/subscribers/subscriber_id?subscriber_id=VALUE&...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#view-a-single-subscriber](https://developers.kit.com/v4#view-a-single-subscriber)
---
#### Update subscriber
**Method**: `PUT` | **LowCodeAPI Path**: `/v4/subscribers/subscriber_id`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/subscribers/subscriber_id?subscriber_id={subscriber_id}&api_token={api_token}
```
**Path Parameters**:
| `subscriber_id` | string | Subscriber ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Body Parameters**:
| `first_name` | string | No | Updated first name for the subscriber. |
| `email_address` | string | No | Updated email address for the subscriber. |
| `fields` | string | No | Updated custom field(s) for your subscriber as object of key/value pairs.The custom field(s) must exist before you can use it here. |
**Example Request**:
```bash
curl -X PUT "https://api.lowcodeapi.com/convertkit/v4/subscribers/subscriber_id?subscriber_id=VALUE&&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"first_name":"value","email_address":"value","fields":"value"}'
```
**Official Documentation**: [https://developers.kit.com/v4#update-subscriber](https://developers.kit.com/v4#update-subscriber)
---
#### Unsubscribe subscriber
**Method**: `PUT` | **LowCodeAPI Path**: `/v4/unsubscribe`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/unsubscribe&api_token={api_token}
```
**Body Parameters**:
| `email` | string | Yes | Subscriber email address |
| `api_secret` | string | Yes | Your API secret key. |
**Example Request**:
```bash
curl -X PUT "https://api.lowcodeapi.com/convertkit/v4/unsubscribe?&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"email":"value","api_secret":"value"}'
```
**Official Documentation**: [https://developers.kit.com/v4#unsubscribe-subscriber](https://developers.kit.com/v4#unsubscribe-subscriber)
---
#### List tags for a subscriber
**Method**: `GET` | **LowCodeAPI Path**: `/v4/subscribers/subscriber_id/tags`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/subscribers/subscriber_id/tags?subscriber_id={subscriber_id}&...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
**Path Parameters**:
| `subscriber_id` | string | Subscriber ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/subscribers/subscriber_id/tags?subscriber_id=VALUE&...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#list-tags-for-a-subscriber](https://developers.kit.com/v4#list-tags-for-a-subscriber)
---
#### List sequences for a subscriber
**Method**: `GET` | **LowCodeAPI Path**: `/v4/subscribers/subscriber_id/sequences`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/subscribers/subscriber_id/sequences?subscriber_id={subscriber_id}&...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
**Path Parameters**:
| `subscriber_id` | string | Subscriber ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/subscribers/subscriber_id/sequences?subscriber_id=VALUE&...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#list-sequences-for-a-subscriber](https://developers.kit.com/v4#list-sequences-for-a-subscriber)
---
#### List forms for a subscriber
**Method**: `GET` | **LowCodeAPI Path**: `/v4/subscribers/subscriber_id/forms`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/subscribers/subscriber_id/forms?subscriber_id={subscriber_id}&...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
**Path Parameters**:
| `subscriber_id` | string | Subscriber ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/subscribers/subscriber_id/forms?subscriber_id=VALUE&...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#list-forms-for-a-subscriber](https://developers.kit.com/v4#list-forms-for-a-subscriber)
---
#### List purchases for a subscriber
**Method**: `GET` | **LowCodeAPI Path**: `/v4/subscribers/subscriber_id/purchases`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/subscribers/subscriber_id/purchases?subscriber_id={subscriber_id}&...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
| `page` | string | No | The page of results being requested |
**Path Parameters**:
| `subscriber_id` | string | Subscriber ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/subscribers/subscriber_id/purchases?subscriber_id=VALUE&...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#list-purchases-for-a-subscriber](https://developers.kit.com/v4#list-purchases-for-a-subscriber)
---
### Category: Tags
#### List tags
**Method**: `GET` | **LowCodeAPI Path**: `/v4/tags`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/tags?...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key. |
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/tags?...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#list-tags](https://developers.kit.com/v4#list-tags)
---
#### Create a tag
**Method**: `POST` | **LowCodeAPI Path**: `/v4/tags`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/tags&api_token={api_token}
```
**Body Parameters**:
| `tag` | string | Yes | a JSON object or an array of JSON objects respectively that includes the tag name |
| `api_secret` | string | Yes | Your API secret key. |
**Example Request**:
```bash
curl -X POST "https://api.lowcodeapi.com/convertkit/v4/tags?&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"tag":"value","api_secret":"value"}'
```
**Official Documentation**: [https://developers.kit.com/v4#create-a-tag](https://developers.kit.com/v4#create-a-tag)
---
#### Tag a subscriber
**Method**: `POST` | **LowCodeAPI Path**: `/v4/tags/tag_id/subscribe`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/tags/tag_id/subscribe?tag_id={tag_id}&api_token={api_token}
```
**Path Parameters**:
| `tag_id` | string | Tag ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Body Parameters**:
| `api_secret` | string | Yes | Your API secret key |
| `email` | string | Yes | Subscriber email address |
| `first_name` | string | No | Subscriber first name |
| `fields` | string | No | Object of key/value pairs for custom field(s).The custom field(s) must exist before you can use it here |
| `tags` | string | No | Array of tag ids to subscribe to |
**Example Request**:
```bash
curl -X POST "https://api.lowcodeapi.com/convertkit/v4/tags/tag_id/subscribe?tag_id=VALUE&&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"api_secret":"value","email":"value","first_name":"value"}'
```
**Official Documentation**: [https://developers.kit.com/v4#tag-a-subscriber](https://developers.kit.com/v4#tag-a-subscriber)
---
#### Remove tag from a subscriber
**Method**: `DELETE` | **LowCodeAPI Path**: `/v4/subscribers/subscriber_id/tags/tag_id`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/subscribers/subscriber_id/tags/tag_id?subscriber_id={subscriber_id}&tag_id={tag_id}&...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
**Path Parameters**:
| `subscriber_id` | string | Subscriber ID |
| `tag_id` | string | Tag ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X DELETE "https://api.lowcodeapi.com/convertkit/v4/subscribers/subscriber_id/tags/tag_id?subscriber_id=VALUE&...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#remove-tag-from-a-subscriber](https://developers.kit.com/v4#remove-tag-from-a-subscriber)
---
#### Remove tag from a subscriber by email
**Method**: `POST` | **LowCodeAPI Path**: `/v4/tags/tag_id/unsubscribe`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/tags/tag_id/unsubscribe?tag_id={tag_id}&api_token={api_token}
```
**Path Parameters**:
| `tag_id` | string | Tag ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Body Parameters**:
| `email` | string | Yes | Subscriber email address |
| `api_secret` | string | Yes | Your API secret key |
**Example Request**:
```bash
curl -X POST "https://api.lowcodeapi.com/convertkit/v4/tags/tag_id/unsubscribe?tag_id=VALUE&&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"email":"value","api_secret":"value"}'
```
**Official Documentation**: [https://developers.kit.com/v4#remove-tag-from-a-subscriber-by-email](https://developers.kit.com/v4#remove-tag-from-a-subscriber-by-email)
---
#### List subscriptions to a tag
**Method**: `GET` | **LowCodeAPI Path**: `/v4/tags/tag_id/subscriptions`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/tags/tag_id/subscriptions?tag_id={tag_id}&...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
| `sort_order` | string | No | asc to list subscribers added oldest to newest desc to list subscribers added newest to oldest. asc is the default order. |
| `subscriber_state` | string | No | receive only active subscribers or cancelled subscribers |
| `page` | string | No | the page to retrieve. 50 results are returned per page. |
**Path Parameters**:
| `tag_id` | string | Tag ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/tags/tag_id/subscriptions?tag_id=VALUE&...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#list-subscriptions-to-a-tag](https://developers.kit.com/v4#list-subscriptions-to-a-tag)
---
### Category: Webhooks
#### List webhooks
**Method**: `GET` | **LowCodeAPI Path**: `/v4/automations/hooks`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/automations/hooks?...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/automations/hooks?...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#list-webhooks](https://developers.kit.com/v4#list-webhooks)
---
#### Create a webhook
**Method**: `POST` | **LowCodeAPI Path**: `/v4/automations/hooks`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/automations/hooks&api_token={api_token}
```
**Body Parameters**:
| `target_url` | string | Yes | The URL that will receive subscriber data when the event is triggered |
| `event` | string | Yes | JSON object that includes the trigger name and extra information when needed. |
**Example Request**:
```bash
curl -X POST "https://api.lowcodeapi.com/convertkit/v4/automations/hooks?&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"target_url":"value","event":"value"}'
```
**Official Documentation**: [https://developers.kit.com/v4#create-a-webhook](https://developers.kit.com/v4#create-a-webhook)
---
#### Get webhook
**Method**: `GET` | **LowCodeAPI Path**: `/v4/automations/hooks/rule_id`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/automations/hooks/rule_id?rule_id={rule_id}&...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
**Path Parameters**:
| `rule_id` | string | Rule ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/automations/hooks/rule_id?rule_id=VALUE&...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#get-webhook](https://developers.kit.com/v4#get-webhook)
---
#### Destroy webhook
**Method**: `DELETE` | **LowCodeAPI Path**: `/v4/automations/hooks/rule_id`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/automations/hooks/rule_id?rule_id={rule_id}&...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
**Path Parameters**:
| `rule_id` | string | Rule ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X DELETE "https://api.lowcodeapi.com/convertkit/v4/automations/hooks/rule_id?rule_id=VALUE&...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#destroy-webhook](https://developers.kit.com/v4#destroy-webhook)
---
#### Update webhook
**Method**: `PUT` | **LowCodeAPI Path**: `/v4/automations/hooks/rule_id`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/automations/hooks/rule_id?rule_id={rule_id}&api_token={api_token}
```
**Path Parameters**:
| `rule_id` | string | Rule ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Body Parameters**:
| `api_secret` | string | Yes | Your API secret key |
| `target_url` | string | No | The URL that will receive subscriber data when the event is triggered |
| `event` | string | No | JSON object that includes the trigger name and extra information when needed |
**Example Request**:
```bash
curl -X PUT "https://api.lowcodeapi.com/convertkit/v4/automations/hooks/rule_id?rule_id=VALUE&&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"api_secret":"value","target_url":"value","event":"value"}'
```
**Official Documentation**: [https://developers.kit.com/v4#update-webhook](https://developers.kit.com/v4#update-webhook)
---
### Category: Products
#### List products
**Method**: `GET` | **LowCodeAPI Path**: `/v4/products`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/products?...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
| `page` | string | No | The page of results being requested |
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/products?...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#list-products](https://developers.kit.com/v4#list-products)
---
#### Create a product
**Method**: `POST` | **LowCodeAPI Path**: `/v4/products`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/products&api_token={api_token}
```
**Body Parameters**:
| `api_secret` | string | Yes | Your API secret key |
| `name` | string | Yes | The product name |
| `description` | string | No | The product description |
| `price` | string | No | The product price |
| `url` | string | No | The product URL |
**Example Request**:
```bash
curl -X POST "https://api.lowcodeapi.com/convertkit/v4/products?&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"api_secret":"value","name":"value","description":"value"}'
```
**Official Documentation**: [https://developers.kit.com/v4#create-a-product](https://developers.kit.com/v4#create-a-product)
---
#### Retrieve a specific product
**Method**: `GET` | **LowCodeAPI Path**: `/v4/products/product_id`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/products/product_id?product_id={product_id}&...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
**Path Parameters**:
| `product_id` | string | Product ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/products/product_id?product_id=VALUE&...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#retrieve-a-specific-product](https://developers.kit.com/v4#retrieve-a-specific-product)
---
#### Update a product
**Method**: `PUT` | **LowCodeAPI Path**: `/v4/products/product_id`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/products/product_id?product_id={product_id}&api_token={api_token}
```
**Path Parameters**:
| `product_id` | string | Product ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Body Parameters**:
| `api_secret` | string | Yes | Your API secret key |
| `name` | string | No | The product name |
| `description` | string | No | The product description |
| `price` | string | No | The product price |
| `url` | string | No | The product URL |
**Example Request**:
```bash
curl -X PUT "https://api.lowcodeapi.com/convertkit/v4/products/product_id?product_id=VALUE&&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"api_secret":"value","name":"value","description":"value"}'
```
**Official Documentation**: [https://developers.kit.com/v4#update-a-product](https://developers.kit.com/v4#update-a-product)
---
#### Destroy a product
**Method**: `DELETE` | **LowCodeAPI Path**: `/v4/products/product_id`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/products/product_id?product_id={product_id}&...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
**Path Parameters**:
| `product_id` | string | Product ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X DELETE "https://api.lowcodeapi.com/convertkit/v4/products/product_id?product_id=VALUE&...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#destroy-a-product](https://developers.kit.com/v4#destroy-a-product)
---
### Category: Events
#### List events for a subscriber
**Method**: `GET` | **LowCodeAPI Path**: `/v4/subscribers/subscriber_id/events`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/subscribers/subscriber_id/events?subscriber_id={subscriber_id}&...&api_token={api_token}
```
**Query Parameters**:
| `api_secret` | string | Yes | Your API secret key |
| `page` | string | No | The page of results being requested |
**Path Parameters**:
| `subscriber_id` | string | Subscriber ID |
**Note**: Path parameters are passed in the URL path. The LowCodeAPI path uses static parameter names, and the actual values are passed as query parameters with the same names.
**Example Request**:
```bash
curl -X GET "https://api.lowcodeapi.com/convertkit/v4/subscribers/subscriber_id/events?subscriber_id=VALUE&...&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json"
```
**Official Documentation**: [https://developers.kit.com/v4#list-events-for-a-subscriber](https://developers.kit.com/v4#list-events-for-a-subscriber)
---
#### Create an event
**Method**: `POST` | **LowCodeAPI Path**: `/v4/events`
**Full URL**:
```
https://api.lowcodeapi.com/convertkit/v4/events&api_token={api_token}
```
**Body Parameters**:
| `api_secret` | string | Yes | Your API secret key |
| `email` | string | Yes | Subscriber email address |
| `name` | string | Yes | Event name |
| `properties` | string | No | Object of key/value pairs for event properties |
**Example Request**:
```bash
curl -X POST "https://api.lowcodeapi.com/convertkit/v4/events?&api_token=YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"api_secret":"value","email":"value","name":"value"}'
```
**Official Documentation**: [https://developers.kit.com/v4#create-an-event](https://developers.kit.com/v4#create-an-event)
---
## Usage Examples
### Example 1: Basic Usage
Get started with Kit Formerly ConvertKit API by making your first request.
```bash
# Your example code here
# This demonstrates basic usage
curl -X GET "https://api.lowcodeapi.com/convertkit/?api_token=YOUR_API_TOKEN"
```
### Example 2: Advanced Usage
Explore more advanced features and parameters.
```bash
# Your example code here
# This demonstrates advanced usage
curl -X GET "https://api.lowcodeapi.com/convertkit/?api_token=YOUR_API_TOKEN"
```
## Complete Endpoint Reference
For a complete list of all endpoints and their parameters, refer to:
- **OpenAPI Definition**: `https://backend.lowcodeapi.com/convertkit/definition`
- **Official Provider Documentation**: [https://developers.kit.com/v4#introduction](https://developers.kit.com/v4#introduction)
## Rate Limits & Best Practices
- Check your Kit Formerly ConvertKit account for specific rate limits
- Use appropriate error handling and retry logic
- Cache responses when appropriate to reduce API calls
## Error Handling
Standard HTTP status codes apply:
- `400` - Invalid request parameters
- `401` - Unauthorized (check your API key)
- `429` - Rate limit exceeded
- `500` - Internal server error