Create a sequence email
Adds a single email to a sequence. Each sequence email represents one step subscribers receive on their journey through the sequence — its position determines order, and delay_value / delay_unit / send_days determine when it fires relative to either the previous email or the subscriber’s entry.
subject, delay_value, and delay_unit are required. Day-based emails (delay_unit: "days") follow the parent sequence’s send_days and send_hour; their per-email send_days (e.g. ["monday", "wednesday"]) overrides the sequence schedule for that one email. Hour-based emails (delay_unit: "hours") ignore the sequence schedule and fire once the delay elapses — Kit checks for hour-delayed sends every 15 minutes — and always return send_days as null.
New emails are created in draft (published: false) so they don’t go out until you flip the flag. position is auto-assigned to the end of the sequence if omitted. content accepts HTML and can embed snippets with {{ snippet.<key> }} — see Create a snippet — which Kit resolves at send time, so editing a snippet later updates every email referencing it without a re-publish.
Note: only the first email in a sequence can be an immediate send (delay_value: 0 with delay_unit: "days"). Subsequent emails need a positive delay.
Warning: publishing an immediate first email, or inserting a new email at a position earlier than where existing subscribers sit, processes those subscribers and triggers a send right away. Plan around active sequences carefully.
For end-user context on how creators build sequences in the Kit UI, see the help article on creating and sending a sequence.
Documentation Index
Fetch the complete documentation index at: https://developers.kit.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Authenticate API requests via an API Key
Path Parameters
Body
Subject line of the email
Number of days or hours to wait before sending this email after the previous one
Unit for the send delay. Use days for schedule-aware delivery, hours for a fixed hourly delay
days, hours Preview text shown in email clients before the email is opened
HTML body content of the email
ID of the email template to use for layout and styling
Whether the email is active and will be sent to subscribers. Defaults to false (draft)
Days of the week this email may be sent. Defaults to all 7 days (inherits the sequence schedule). Pass a subset to restrict delivery, or null to reset to all days
Zero-based position of the email in the sequence. Assigned automatically after the last email if omitted
Response
Creates a new sequence email