Update Sequence Step

Updates an existing step within a sequence.

PATCH /sequences/{sequenceId}/steps/{stepId}

cURL

Update Email Step

curl --request PATCH \ --url https://api.lemlist.com/api/sequences/{sequenceId}/steps/{stepId} \ --header 'Authorization: Basic <encoded-value>' \ --header 'Content-Type: application/json' \ --data ' { "type": "email" } '

200

{
  "_id": "stp_V0JHmSpWiO0rxHUkz",
  "type": "linkedinInvite",
  "delay": 0,
  "emailTemplateId": "etp_HZvLoLNEwdJ8Vu0w7",
  "message": "Hello, I want to..."
}

Use this endpoint to:

• Edit the message content or subject of the step
• Change the delay before this step executes
• Update the title (for manual steps)
• Change method/URL (for API steps)
• Adjust delay logic for conditional steps

You cannot change the type of a step (e.g., from email to linkedinInvite). To do so, delete the step and create a new one. However, you need to add the type field in the request body even if you can’t modify it…

Supported Step Types

Type	Editable Fields	Description
email	subject, message, delay	Sends an email to the lead
manual	title, message, delay	Manual task to be performed by the user
phone	message, delay	Reminder to make a phone call
api	method, url, delay	Makes an API call
linkedinVisit	delay	Simulates a profile visit on LinkedIn
linkedinInvite	message, images, videos, delay	Sends a LinkedIn invite with message
linkedinSend	message, altMessage, images, videos, delay	Sends a LinkedIn message
linkedinVoiceNote	delay, recordMode	Sends a LinkedIn voice note. Audio is either recorded manually or AI-generated from a text template, depending on recordMode
linkedinFollow	delay	Follows the lead on LinkedIn
linkedinLikeLastPost	delay	Likes the lead’s most recent LinkedIn post
linkedinCommentLastPost	delay	Posts an AI-generated comment on the lead’s most recent LinkedIn post
linkedinEndorse	delay, skillName, endorseAnyFallback	Endorses a skill on the lead’s LinkedIn profile
linkedinWithdrawInvitation	delay	Withdraws a pending LinkedIn invite
sendToAnotherCampaign	campaignId	Sends the lead to another campaign
conditional	conditionKey, delayType, delay	Triggers the next step based on lead behavior
whatsappMessage	message, delay	Sends a WhatsApp message
sms	message, delay	Sends an SMS to the lead

Request Body

Only include the fields you want to update. Required fields are not enforced here.

Field	Type	Applies To	Description
subject	string	email	Email subject line. Maximum 400 characters (applied to the raw template, including any Liquid syntax)
message	string	email, linkedin*, manual, phone, whatsappMessage, sms	Message text
altMessage	string	linkedinSend	Fallback LinkedIn message
title	string	manual	Title for manual task. Maximum 400 characters
method	string	api	One of GET, POST, PUT, DELETE, PATCH
url	string	api	Valid HTTP/HTTPS URL
delay	integer	all except sendToAnotherCampaign	Delay before this step, in days. Must be between 0 and 1500
delayType	string	conditional	One of within, waitUntil
conditionKey	string	conditional	See supported condition keys below
campaignId	string	sendToAnotherCampaign	ID of destination campaign
images	array of strings	linkedinInvite, linkedinSend	Public HTTPS URLs of images to attach. Replaces the step’s current images — pass [] to clear them. See the LinkedIn media constraints on Add Step
videos	array of strings	linkedinInvite, linkedinSend	Public HTTPS URLs of videos to attach. Replaces the step’s current videos — pass [] to clear them. See the LinkedIn media constraints on Add Step
skillName	string	linkedinEndorse	Name of the LinkedIn skill to endorse on the lead’s profile
endorseAnyFallback	boolean	linkedinEndorse	When true and the named skill is not on the lead’s profile, lemlist falls back to endorsing any available skill
recordMode	string	linkedinVoiceNote	One of manual (user records the audio after step creation; default) or ai (audio is generated from a text template provided in the lemlist UI)

Supported Condition Keys

For conditional steps:

• hasEmailAddress
• hasLinkedinUrl
• hasPhoneNumber
• hasScore
• emailsOpened
• emailsClicked
• emailsUnsubscribed
• meetingBooked
• linkedinInviteAccepted
• linkedinOpened
• aircallDone
• linkedinNetworkCheck
• hasWhatsappAccount

Authorizations

Authorization · string · header · required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

sequenceId · string · required

The unique identifier of the sequence

stepId · string · required

The unique identifier of the step

Body

application/json

type · enum<string> · required

The type of step (required but cannot be changed - must match the existing step type)

Available options: email, manual, phone, api, linkedinVisit, linkedinInvite, linkedinSend, linkedinVoiceNote, linkedinFollow, linkedinLikeLastPost, linkedinCommentLastPost, linkedinEndorse, linkedinWithdrawInvitation, sendToAnotherCampaign, conditional, whatsappMessage, sms

delay · integer

Delay in days before executing this step

subject · string

Email subject line (for email steps)

message · string

Content of the email or message (for email, linkedinInvite, linkedinSend, manual, phone, whatsappMessage, sms steps)

altMessage · string

Alternate message for linkedinSend steps

title · string

Title or label for manual steps

method · enum<string>

HTTP method for API steps

Available options: GET, POST, PUT, DELETE, PATCH

url · string

URL of the API endpoint to call (for api steps). Must start with http:// or https://

conditionKey · enum<string>

Condition key for conditional steps

Available options: hasEmailAddress, hasLinkedinUrl, hasPhoneNumber, hasScore, emailsOpened, emailsClicked, emailsUnsubscribed, meetingBooked, linkedinInviteAccepted, linkedinOpened, aircallDone, linkedinNetworkCheck, hasWhatsappAccount

delayType · enum<string>

Delay type for conditional steps

Available options: within, waitUntil

campaignId · string

Target campaign ID for sendToAnotherCampaign steps. The campaign must exist and not be archived

images · string<uri>[]

Public HTTPS URLs of images to attach to a linkedinInvite or linkedinSend step. Replaces the step's current images — pass an empty array to clear them. Allowed MIME types: image/png, image/jpeg, image/gif. Up to 20 MB per file, and up to 6 items total combined with videos.

videos · string<uri>[]

Public HTTPS URLs of videos to attach to a linkedinInvite or linkedinSend step. Replaces the step's current videos — pass an empty array to clear them. Allowed MIME types: video/mp4, video/quicktime. Up to 20 MB per file, and up to 6 items total combined with images.

skillName · string

Name of the LinkedIn skill to endorse on the lead's profile. Applies to linkedinEndorse steps only.

endorseAnyFallback · boolean

Applies to linkedinEndorse steps only. When true and the named skill is not on the lead's profile, lemlist falls back to endorsing any available skill.

recordMode · enum<string>

Applies to linkedinVoiceNote steps only. Determines how the audio is sourced. manual (default) means the user records the audio themselves from the lemlist UI after step creation; ai means lemlist generates the audio from a text template provided in the lemlist UI.

Available options: manual, ai

Response

200

application/json

Success

_id · string

type · string

delay · integer

emailTemplateId · string

message · string