Campaigns

Edit an email step

Changes the subject, preview text or body of one email step, in a campaign of any status including running. Only the fields you send change; the step's type, order and timing never do. Emails already sent cannot change: if anybody already received this step the call is refused with already_sent unless you send future_sends_only: true, and then the new text goes to everyone who has not received it yet. If the step has A/B versions, name one with variant. Same checks as creating a campaign (spintax, personalisation tags, body length). Nothing is sent by this call.

Required scope: campaigns:write.

patch/campaigns/{id}/steps/{step_index}

Request

  • Base URL: https://warmysender.com/api/v1
  • URL: https://warmysender.com/api/v1/campaigns/{id}/steps/{step_index}
  • Auth: HTTP bearer

Path parameters

idstring required

Campaign id (UUID).

step_indexinteger required

0-based index of the email step (0 = first email).

Request body

subjectstring

New subject line. Supports spintax and personalisation tags.

preheaderstring

New preview text.

body_htmlstring

New HTML body.

body_textstring

New plain-text body.

variantstring

A/B version to edit (e.g. "B"). Required only when the step has more than one version.

future_sends_onlyboolean

Confirms the edit should go to everyone who has not received this email yet, when some people already got it.

Response

Success

Changes

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