KIkit
Sequence Emails

Update a sequence email

Updates any field on a sequence email — subject, preview_text, content, delay_value, delay_unit, send_days, position, email_template_id, or published. Only fields included in the request body change; everything else is preserved.

Note: pass send_days: null to revert a per-email schedule override and inherit the parent sequence's send_days again. The response will then return all 7 days, indicating no per-email restriction.

Warning: sending send_days on an email with delay_unit: "hours" returns 422 — send_days only applies to day-based emails.

Warning: changing position while subscribers are actively progressing through the sequence can cause emails to be sent out of order or skipped. The same caution applies to flipping published on a position: 0 email — it triggers Kit to process all queued subscribers for that email.

For the sequence-email model and how delay_unit and send_days interact, see Create a sequence email.

put/v4/sequences/{sequence_id}/emails/{id}

Request

  • Base URL
    https://api.kit.com
  • URL
    https://api.kit.com/v4/sequences/{sequence_id}/emails/{id}
  • Auth
    • API key in header X-Kit-Api-Key
    • or OAuth 2
      Authorization code: https://api.kit.com/v4/oauth/authorize
      Token URL: https://api.kit.com/v4/oauth/token

Path parameters

idinteger required
sequence_idinteger required

Request body

subjectstring

New subject line for the email

preview_textstring nullable

New preview text shown in email clients before the email is opened

contentstring nullable

New HTML body content of the email

delay_valueinteger

New delay value

delay_unit'days' | 'hours'

New delay unit. Use days for schedule-aware delivery, hours for a fixed hourly delay

email_template_idinteger nullable

New email template ID for layout and styling. Pass null to clear

publishedboolean

Pass true to publish a draft email or false to unpublish it

send_daysstring[] nullable

Days of the week this email may be sent. Pass a subset to restrict delivery, or null to reset to all days (inherits the sequence schedule)

positioninteger nullable

New zero-based position of the email in the sequence

Response

Updates the sequence email and returns its details

Changes

No recorded changes to this operation across all 2 revisions of this API.