Skip to main content

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.com to the Product Updates form and tag her as beta-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.

  1. Go to Organization > Connectors and find Kit. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Kit developer portal.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. 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.

ToolWhat it does
get_accountGet the authenticated Kit account and the user the API key belongs to, including the plan and the confirmed sending addresses.
get_account_colorsList the brand colors configured on the account.
get_broadcastGet one broadcast by ID, including its body, audience and schedule.
get_broadcast_statsGet delivery and engagement statistics for one broadcast: recipients, opens, clicks and unsubscribes.
get_creator_profileGet the account's public creator profile: display name, byline, bio and public URL.
get_email_statsGet account-wide email performance: sends, opens, clicks and the bounce and unsubscribe rates over Kit's reporting window.
get_growth_statsGet subscriber growth over a date window: new subscribers, cancellations and the net change.
get_postGet one published post by ID, including its body.
get_sequenceGet one sequence by ID, optionally with its send statistics.
get_sequence_emailGet one email from a sequence, including its body and delay.
get_snippetGet one snippet by ID, including its content.
get_subscriberGet one subscriber by ID, including their custom-field values and location.
get_subscriber_statsGet one subscriber's email engagement: sends, opens, clicks, bounces and the time since their last open or click.
list_broadcast_clicksList per-link click totals for one sent broadcast.
list_broadcast_statsList every broadcast with its delivery statistics, filtered by status and sent date.
list_broadcastsList broadcasts with optional status and sent-date filters.
list_custom_fieldsList the account's custom fields.
list_email_templatesList the email templates available to broadcasts and sequences.
list_form_subscribersList the subscribers who joined through one form, with optional state and date filters.
list_formsList the account's forms and landing pages, filtered by lifecycle state and type.
list_postsList the account's published newsletter posts.
list_segmentsList the account's saved subscriber segments.
list_sequence_emailsList the emails in one sequence, in send order.
list_sequence_subscribersList the subscribers enrolled in one sequence, with optional state and date filters.
list_sequencesList the account's sequences, optionally with their send statistics.
list_snippetsList reusable content snippets, filtered by kind and archived state.
list_subscriber_tagsList the tags applied to one subscriber, each with the time it was applied.
list_subscribersList subscribers with optional state, date and email filters, and server-side sorting.
list_tag_subscribersList the subscribers carrying one tag, with optional state and date filters.
list_tagsList the account's tags, newest first.
list_webhooksList the account's registered webhooks and the events they fire on.
search_subscribersSearch subscribers with Kit's condition grammar: opens, clicks, tags, attribution and custom-field conditions.
validate_credentialValidate the Kit API key with a lightweight account lookup.

Write (13)​

Create or send data.

ToolWhat it does
add_subscriber_to_formAdd an existing subscriber to a form by subscriber ID, which triggers the form's automations.
add_subscriber_to_form_by_emailAdd a subscriber to a form by email address.
add_subscriber_to_sequenceEnroll an existing subscriber in a sequence by subscriber ID.
add_subscriber_to_sequence_by_emailEnroll a subscriber in a sequence by email address.
create_broadcastCreate a broadcast.
create_custom_fieldCreate a custom field from a label.
create_sequenceCreate a sequence.
create_sequence_emailAdd an email to a sequence.
create_snippetCreate an inline content snippet that broadcasts and sequence emails can reuse.
create_tagCreate a tag.
create_webhookRegister a webhook that POSTs to a URL when one Kit event fires.
tag_subscriberApply a tag to an existing subscriber by subscriber ID.
tag_subscriber_by_emailApply 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.

ToolWhat it does
create_subscriberCreate a subscriber, or update the existing one with the same email address — Kit upserts on email.
delete_broadcastPermanently delete a broadcast.
delete_custom_fieldPermanently delete a custom field and the values stored against it on every subscriber.
delete_sequencePermanently delete a sequence and the emails inside it.
delete_sequence_emailPermanently delete one email from a sequence.
delete_subscriber_locationClear the location Kit holds for a subscriber.
delete_webhookDelete a webhook so Kit stops posting its event.
remove_tag_from_subscriberRemove a tag from a subscriber by subscriber ID.
remove_tag_from_subscriber_by_emailRemove a tag from a subscriber identified by email address.
set_subscriber_locationSet the location Kit holds for a subscriber.
unsubscribe_subscriberUnsubscribe a subscriber, moving them to the cancelled state.
update_account_colorsReplace the account's brand colors with the list supplied.
update_broadcastUpdate a broadcast's subject, body, schedule or audience.
update_custom_fieldRename a custom field.
update_sequenceUpdate a sequence's name, sending address or schedule.
update_sequence_emailUpdate one email in a sequence.
update_snippetUpdate an inline snippet's name or content, or archive and restore it with archived.
update_subscriberUpdate a subscriber's email address, first name or custom-field values.
update_tagRename a tag.
⌘J