Skip to main content
POST
Skip Step for Leads
Send up to 100 leads per call, each as a lead id or an email. For each lead the step never runs: the lead moves on to the next step after that step’s own delay. Leads that already ran the step are unaffected — nothing already sent changes. The call answers per item and never fails on one: a lead that already had the step skipped answers already_skipped, an item that matches no lead of the campaign answers not_found. Only a request that must be fixed as a whole is refused, such as more than 100 items (400, never truncated) or a condition step (422). A skip cannot be undone, here or in the lemlist app. To skip a step for every lead of the campaign, including leads added later, use Skip Step for Everyone instead.

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

campaignId
string
required

The unique identifier of the campaign

stepId
string
required

The unique identifier of the step, from GET /campaigns/{campaignId}/sequences

Body

application/json
leads
string[]
required

The leads to skip the step for: 1 to 100 items. An email is matched inside the campaign, case-insensitively. A repeated item is read once. An email is not URL-decoded: send it as it is stored.

Required array length: 1 - 100 elements

A lead id (lea_...) or the lead's email

Response

One results row per distinct item sent, echoing it as sent. Per-item outcomes never fail the call: skipped, already_skipped (an idempotent no-op) or not_found (no lead of this campaign matches). Counts are per lead: two items naming the same lead both echo its status, and the lead counts once.

total
integer

skipped + alreadySkipped + the items in notFound

skipped
integer

Leads skipped by this call

alreadySkipped
integer

Leads that already had the step skipped: nothing changed for them

notFound
string[]

The items that matched no lead of the campaign, as sent

results
object[]