Kit

Fetch the connected Kit account and user: account id, name, plan type, primary email address, timezone and the account's sending addresses with verification and DMARC status.

List subscribers in the account. Look one up by exact email_address, or filter by status, creation date, update date and engagement sort order.

Fetch one subscriber: first name, email address, state, creation date and their custom field values under `fields`.

Fetch a subscriber's email stats: sent, opened, clicked and bounced totals, open and click rates, and recency signals (last_sent, last_opened, last_clicked).

List the tags currently applied to a subscriber, each with the tagged_at timestamp.

Create a subscriber. Behaves as an upsert: an existing email address is updated (first name and custom fields) rather than duplicated. Custom field keys must already exist on the account.

Update an existing subscriber's email address, first name or custom field values. Custom field keys must already exist on the account.

Unsubscribe a subscriber from all future emails, moving them to the cancelled state. The record, history and tags are retained.

List all tags in the account with their id, name and creation date.

Create a tag. Idempotent on name (case-insensitive): an existing tag is returned with 200 instead of a duplicate being created.

Rename a tag. It keeps its id and all of its subscribers, and the new name is reflected everywhere the tag is used. Names are unique case-insensitively.

List the subscribers who have a given tag.

Apply a tag to an existing subscriber. The subscriber must already exist — create them with create_subscriber first.

Remove a tag from a subscriber. The subscriber stays in the account and keeps their other tags — only this tag association is removed.

List the account's forms and landing pages. Both live on this endpoint — filter with type=embed for embedded forms or type=hosted for landing pages.

List the subscribers who joined through (or were added to) a form.

Add an existing subscriber to a form. Adding to a double opt-in form triggers its Incentive Email (once per subscriber). The subscriber must already exist.

List the account's sequences (automated email series) with their schedule and active/repeat/hold flags.

List the subscribers in a sequence, each with the added_at timestamp for when they entered it.

Add an existing subscriber to a sequence so they start receiving its emails. The subscriber must already exist.

List broadcasts with their content, targeting, email template and web-publishing settings. Filter by lifecycle status and send date.

Fetch a broadcast's full record: subject, HTML content, preview text, targeting, email template, send schedule and web-publishing details.

Fetch a broadcast's delivery and engagement stats: recipients, opens, clicks, unsubscribes and their rates, plus sending status and progress.

Draft or schedule a broadcast. Omit send_at (or pass null) to save a draft; pass an ISO 8601 send_at to schedule it. Scheduled broadcasts need a subject and content.

Update an existing broadcast — subject, content, schedule, template or targeting. Only the fields you pass change.

Permanently delete a draft or scheduled broadcast. This is a hard delete and cannot be undone.

List the account's custom fields with their label, key and name. The key is what create_subscriber / update_subscriber expect in `fields`.

Create a custom field. The label must be unique in the account; Kit generates the field's key and name from it.

List the account's segments with their id, name and creation date.

List the account's email templates with each template's id, name, is_default flag and category. Use an id as create_broadcast's email_template_id.