Kit

Kit Subscribers API

The Subscribers API from Kit — 7 operation(s) for subscribers.

Documentation GitHub OpenAPI

Business capability

Operations 9

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v4/bulk/subscribers Create many subscribers at once · Bulk create subscribers #

Ask an LLM

“Can I import thousands of subscribers in one request?”

“How do I get told when a bulk subscriber import finishes processing?”

Tell an agent

Bulk create these subscribers: {subscribers}.

Import {subscribers} in bulk and post the result to {callback_url}.

GET /v4/subscribers List and filter subscribers · List subscribers #

Ask an LLM

“Which subscribers joined my list in the last month?”

“Can I find a subscriber by email address in the subscriber list?”

Tell an agent

List subscribers created after {created_after}.

Find the subscriber with email {email_address}.

POST /v4/subscribers Create or upsert a subscriber · Create a subscriber #

Ask an LLM

“How do I add a new subscriber to my email list?”

“What happens if I create a subscriber whose email already exists?”

Tell an agent

Create a subscriber with email {email_address} and first name {first_name}.

Add {email_address} as a new subscriber in state {state}.

POST /v4/subscribers/filter Filter subscribers by engagement · Filter subscribers based on engagement #

Ask an LLM

“Which subscribers opened or clicked my emails recently?”

“Can I find subscribers who meet several engagement conditions at once?”

Tell an agent

Find subscribers matching all of these engagement conditions: {all}.

Filter subscribers by engagement using {all} with counting mode {counting_mode}.

GET /v4/subscribers/{id} Get a subscriber · Get a subscriber #

Ask an LLM

“Can I look up one subscriber's details by their id?”

“What state and custom fields does a specific subscriber have?”

Tell an agent

Get subscriber {id}.

Show me the profile and custom fields of subscriber {id}.

PUT /v4/subscribers/{id} Update a subscriber's details · Update a subscriber #

Ask an LLM

“How do I change an existing subscriber's email address or first name?”

“Why does updating a subscriber fail when I pass an unknown custom field key?”

Tell an agent

Change subscriber {id}'s email to {email_address}.

Update subscriber {id} with email {email_address} and custom fields {fields}.

POST /v4/subscribers/{id}/unsubscribe Unsubscribe a subscriber · Unsubscribe subscriber #

Ask an LLM

“How do I unsubscribe someone from all my emails?”

“Can I cancel a subscriber's subscription through the API?”

Tell an agent destructive · confirm first

Unsubscribe subscriber {id}.

Stop all emails to subscriber {id} by unsubscribing them.

GET /v4/subscribers/{subscriber_id}/stats Get email stats for one subscriber · List stats for a subscriber #

Ask an LLM

“How engaged is a specific subscriber with my emails?”

“Can I limit a subscriber's open and click stats to emails sent in a date range?”

Tell an agent

Show email stats for subscriber {subscriber_id}.

Get subscriber {subscriber_id}'s stats for emails sent after {email_sent_after}.

GET /v4/subscribers/{subscriber_id}/tags List a subscriber's tags · List tags for a subscriber #

Ask an LLM

“Which tags are applied to a particular subscriber?”

“Can I see every tag one person has been given?”

Tell an agent

List the tags on subscriber {subscriber_id}.

Show which tags subscriber {subscriber_id} has.

Kit Subscribers API

Operations 9

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification