Lemlist Developer Docs

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"
}
'

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

"Bad team"

"The authentication you supplied is incorrect"

PATCH

sequences

{sequenceId}

steps

{stepId}

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"
}
'

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

"Bad team"

"The authentication you supplied is incorrect"

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

Success

_id

string

type

string

delay

integer

emailTemplateId

string

message

string

Add Step to Sequence Delete Sequence Step

⌘I

Getting started

Popular Resources

Endpoints

Objects & Definitions

Update Sequence Step

Supported Step Types

Request Body

Supported Condition Keys

Authorizations

Path Parameters

Body

Response

​Supported Step Types

​Request Body

​Supported Condition Keys

Authorizations

Path Parameters

Body

Response

Supported Step Types

Request Body

Supported Condition Keys