Create Campaign

Creates a new campaign with auto-generated sequence and schedule.

POST /campaigns

Create Campaign

cURL

curl --request POST \
  --url https://api.lemlist.com/api/campaigns \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "My new campaign"
}
'

200

{
  "_id": "cam_kok3I33Sba7mcNIO7",
  "sequenceId": "seq_ScVmFnlKdP6aVmyZN",
  "scheduleIds": [
    "skd_IrCdCoQ0ZUAEeUDwR"
  ],
  "teamId": "tea_edrkv2LgUK4Wf4ZzO",
  "createdBy": "usr_Sy3xIhbEi7auHFv5A",
  "createdAt": "2025-01-16T13:53:22.726Z",
  "state": "running",
  "scannedCount": 0,
  "reviewedCount": 0,
  "inSequenceLeadCount": 0,
  "variableKeys": [],
  "senders": [],
  "sendUsers": [],
  "displayedVariableKeys": [
    "companyName"
  ],
  "emoji": "🚀",
  "stopOnEmailReplied": true,
  "crmOpportunitiesOnTask": true,
  "unsubscribe": "campaign",
  "name": "My new campaign",
  "crm": "hubspot",
  "crmUserId": "usr_0p9Q8ZyXSTNGpsHOe"
}

When you create a new campaign, an empty sequence and default schedule are automatically added. You can specify a name, or one will be assigned by default.

You can optionally set a timezone (IANA format, e.g. America/New_York) to control the campaign schedule’s timezone. If omitted, it defaults to Europe/Paris.

Set autoReview to true to automatically launch leads as soon as they are added to the campaign, skipping manual review. Use autoReviewConditions to restrict auto-launch to leads whose email verification matches one of the given deliverability statuses (deliverable, risky, undeliverable, unverified). Passing an invalid status returns a 400 error.

The returned data includes the campaign, sequence, and schedule IDs, which you can use later to update campaign settings, add sequence steps, or modify the schedule.

Authorizations

Authorization · string · header · required

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

Body

application/json

name · string · required

The name of the campaign

timezone · string

IANA timezone for the campaign schedule (e.g. America/New_York). Defaults to Europe/Paris if omitted.

autoReview · boolean

Automatically launch (review) leads as soon as they are added to the campaign, instead of requiring manual review. Defaults to false.

autoReviewConditions · enum<string>[]

Email deliverability statuses for which a lead is auto-launched when autoReview is enabled. Only leads whose email verification matches one of these statuses are launched automatically. Invalid values are rejected with a 400 error.

Available options: deliverable, risky, undeliverable, unverified

Response

200

application/json

Success

_id · string

sequenceId · string

scheduleIds · string[]

teamId · string

createdBy · string

createdAt · string<date-time>

state · string

scannedCount · integer

reviewedCount · integer

inSequenceLeadCount · integer

variableKeys · any[]

senders · any[]

sendUsers · any[]

displayedVariableKeys · string[]

emoji · string

stopOnEmailReplied · boolean

crmOpportunitiesOnTask · boolean

unsubscribe · string

name · string

crm · string

crmUserId · string