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.