Skip to main content
POST
Launch Lead
Use this endpoint to launch a lead that is waiting for review, without having to enable campaign-wide auto-review. You’re auto launching this specific lead, while still enforcing every other launch guard: the campaign must have no step errors, any AI variables required by the campaign must be valid for the lead, and a sender must be available. No need to enable autolaunch in the campaign. This endpoint requires an emailPro plan or higher.

Retries

Retrying is safe once a call has completed: a lead that is already launched is refused with CAMPAIGN_LEAD_REVIEW_LEAD_ALREADY_REVIEWED, so it is never launched twice. Do not send concurrent calls for the same lead.

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

leadId
string
required

The unique identifier of the lead to launch

Response

Lead launched successfully

ok
boolean
launched
integer

Number of leads launched: 1, or 0 when the lead left review between the checks and the launch