Kit
Kit (formerly ConvertKit) email marketing — manage subscribers, tags, custom fields, forms, sequences, broadcasts, snippets and webhooks, and read account, growth and engagement statistics.
Categories: Marketing Automation, Email Marketing, Marketing
What you can ask
- Show open and click rates for every broadcast sent in the last 30 days.
- Add
alice@acme.comto the Product Updates form and tag her asbeta-tester. - Draft a broadcast announcing the June webinar to the Customers segment, but don't send it.
Set up
Kit needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.
- Go to Organization > Connectors and find Kit. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Kit developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- Each member connects their own account the first time they use it.
⚠️ Warning: Do not enter your Devs.ai or Kit login email or password in the OAuth application fields.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
Tools
Kit offers 65 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (33)
View and search information without changing it.
| Tool | What it does |
|---|---|
get_account | Get the authenticated Kit account and the user the API key belongs to, including the plan and the confirmed sending addresses. |
get_account_colors | List the brand colors configured on the account. |
get_broadcast | Get one broadcast by ID, including its body, audience and schedule. |
get_broadcast_stats | Get delivery and engagement statistics for one broadcast: recipients, opens, clicks and unsubscribes. |
get_creator_profile | Get the account's public creator profile: display name, byline, bio and public URL. |
get_email_stats | Get account-wide email performance: sends, opens, clicks and the bounce and unsubscribe rates over Kit's reporting window. |
get_growth_stats | Get subscriber growth over a date window: new subscribers, cancellations and the net change. |
get_post | Get one published post by ID, including its body. |
get_sequence | Get one sequence by ID, optionally with its send statistics. |
get_sequence_email | Get one email from a sequence, including its body and delay. |
get_snippet | Get one snippet by ID, including its content. |
get_subscriber | Get one subscriber by ID, including their custom-field values and location. |
get_subscriber_stats | Get one subscriber's email engagement: sends, opens, clicks, bounces and the time since their last open or click. |
list_broadcast_clicks | List per-link click totals for one sent broadcast. |
list_broadcast_stats | List every broadcast with its delivery statistics, filtered by status and sent date. |
list_broadcasts | List broadcasts with optional status and sent-date filters. |
list_custom_fields | List the account's custom fields. |
list_email_templates | List the email templates available to broadcasts and sequences. |
list_form_subscribers | List the subscribers who joined through one form, with optional state and date filters. |
list_forms | List the account's forms and landing pages, filtered by lifecycle state and type. |
list_posts | List the account's published newsletter posts. |
list_segments | List the account's saved subscriber segments. |
list_sequence_emails | List the emails in one sequence, in send order. |
list_sequence_subscribers | List the subscribers enrolled in one sequence, with optional state and date filters. |
list_sequences | List the account's sequences, optionally with their send statistics. |
list_snippets | List reusable content snippets, filtered by kind and archived state. |
list_subscriber_tags | List the tags applied to one subscriber, each with the time it was applied. |
list_subscribers | List subscribers with optional state, date and email filters, and server-side sorting. |
list_tag_subscribers | List the subscribers carrying one tag, with optional state and date filters. |
list_tags | List the account's tags, newest first. |
list_webhooks | List the account's registered webhooks and the events they fire on. |
search_subscribers | Search subscribers with Kit's condition grammar: opens, clicks, tags, attribution and custom-field conditions. |
validate_credential | Validate the Kit API key with a lightweight account lookup. |
Write (13)
Create or send data.
| Tool | What it does |
|---|---|
add_subscriber_to_form | Add an existing subscriber to a form by subscriber ID, which triggers the form's automations. |
add_subscriber_to_form_by_email | Add a subscriber to a form by email address. |
add_subscriber_to_sequence | Enroll an existing subscriber in a sequence by subscriber ID. |
add_subscriber_to_sequence_by_email | Enroll a subscriber in a sequence by email address. |
create_broadcast | Create a broadcast. |
create_custom_field | Create a custom field from a label. |
create_sequence | Create a sequence. |
create_sequence_email | Add an email to a sequence. |
create_snippet | Create an inline content snippet that broadcasts and sequence emails can reuse. |
create_tag | Create a tag. |
create_webhook | Register a webhook that POSTs to a URL when one Kit event fires. |
tag_subscriber | Apply a tag to an existing subscriber by subscriber ID. |
tag_subscriber_by_email | Apply a tag to a subscriber identified by email address, creating the subscriber when the address is new. |
Delete or overwrite (19)
Remove or replace existing data.
| Tool | What it does |
|---|---|
create_subscriber | Create a subscriber, or update the existing one with the same email address — Kit upserts on email. |
delete_broadcast | Permanently delete a broadcast. |
delete_custom_field | Permanently delete a custom field and the values stored against it on every subscriber. |
delete_sequence | Permanently delete a sequence and the emails inside it. |
delete_sequence_email | Permanently delete one email from a sequence. |
delete_subscriber_location | Clear the location Kit holds for a subscriber. |
delete_webhook | Delete a webhook so Kit stops posting its event. |
remove_tag_from_subscriber | Remove a tag from a subscriber by subscriber ID. |
remove_tag_from_subscriber_by_email | Remove a tag from a subscriber identified by email address. |
set_subscriber_location | Set the location Kit holds for a subscriber. |
unsubscribe_subscriber | Unsubscribe a subscriber, moving them to the cancelled state. |
update_account_colors | Replace the account's brand colors with the list supplied. |
update_broadcast | Update a broadcast's subject, body, schedule or audience. |
update_custom_field | Rename a custom field. |
update_sequence | Update a sequence's name, sending address or schedule. |
update_sequence_email | Update one email in a sequence. |
update_snippet | Update an inline snippet's name or content, or archive and restore it with archived. |
update_subscriber | Update a subscriber's email address, first name or custom-field values. |
update_tag | Rename a tag. |