Access the Lemlist API with managed OAuth authentication. Manage campaigns, leads, activities, schedules, sequences, and unsubscribes for sales automation and cold outreach.
Reference
Get Team
GET /lemlist/api/teamReturns team information including user IDs and settings.
Get Team Credits
GET /lemlist/api/team/creditsReturns remaining credits balance.
Get Team Senders
GET /lemlist/api/team/sendersReturns all team members and their associated campaigns.
List Campaigns
GET /lemlist/api/campaignsCreate Campaign
POST /lemlist/api/campaigns
Content-Type: application/json
{
"name": "My Campaign"
}Creates a new campaign with an empty sequence and default schedule automatically added.
Get Campaign
GET /lemlist/api/campaigns/{campaignId}Update Campaign
PATCH /lemlist/api/campaigns/{campaignId}
Content-Type: application/json
{
"name": "Updated Campaign Name"
}Pause Campaign
POST /lemlist/api/campaigns/{campaignId}/pausePauses a running campaign.
Get Campaign Sequences
GET /lemlist/api/campaigns/{campaignId}/sequencesReturns all sequences and steps for a campaign.
Get Campaign Schedules
GET /lemlist/api/campaigns/{campaignId}/schedulesReturns all schedules associated with a campaign.
Add Lead to Campaign
POST /lemlist/api/campaigns/{campaignId}/leads
Content-Type: application/json
{
"email": "lead@example.com",
"firstName": "John",
"lastName": "Doe",
"companyName": "Acme Inc"
}Creates a new lead and adds it to the campaign. If the lead already exists, it will be inserted into the campaign.
Get Lead by Email
GET /lemlist/api/leads/{email}Update Lead in Campaign
PATCH /lemlist/api/campaigns/{campaignId}/leads/{email}
Content-Type: application/json
{
"firstName": "Jane",
"lastName": "Smith"
}Delete Lead from Campaign
DELETE /lemlist/api/campaigns/{campaignId}/leads/{email}List Activities
GET /lemlist/api/activitiesReturns the history of campaign activities (last 100 activities).
Query parameters:
campaignId- Filter by campaigntype- Filter by activity type (emailsSent, emailsOpened, emailsClicked, etc.)
List Schedules
GET /lemlist/api/schedulesReturns all schedules with pagination.
Response:
{
"schedules": [...],
"pagination": {
"totalRecords": 10,
"currentPage": 1,
"nextPage": 2,
"totalPage": 2
}
}Create Schedule
POST /lemlist/api/schedules
Content-Type: application/json
{
"name": "Business Hours",
"timezone": "America/New_York",
"start": "09:00",
"end": "17:00",
"weekdays": [1, 2, 3, 4, 5]
}Weekdays: 0 = Sunday, 1 = Monday, ..., 6 = Saturday
Get Schedule
GET /lemlist/api/schedules/{scheduleId}Update Schedule
PATCH /lemlist/api/schedules/{scheduleId}
Content-Type: application/json
{
"name": "Updated Schedule",
"start": "08:00",
"end": "18:00"
}Delete Schedule
DELETE /lemlist/api/schedules/{scheduleId}List Companies
GET /lemlist/api/companiesReturns companies with pagination.
Response:
{
"data": [...],
"total": 100
}List Unsubscribes
GET /lemlist/api/unsubscribesReturns all unsubscribed emails and domains.
Add Unsubscribe
POST /lemlist/api/unsubscribes
Content-Type: application/json
{
"email": "unsubscribe@example.com"
}Can also add domains by using a domain value.
List Labels
GET /lemlist/api/inbox/labelsReturns all labels available to the team.