Skip to main content
POST
/
campaigns
Create Campaign
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"
}
'
{
  "_id": "cam_WN3M22c3gDs4eQDXN",
  "sequenceId": "seq_hPj7N88tCgpFYgtnj",
  "scheduleIds": [
    "skd_isFGZkjSsvJZ7CfRx"
  ],
  "teamId": "tea_MtScZ2GexXzHXRdTr",
  "createdBy": "usr_XCQktNJNa79X5Tvnh",
  "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_BXJcMBSk7pwhdqAL2"
}
This endpoint uses the Campaign object.
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. 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

Response

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