Skip to main content
POST
/
schedules
Create Schedule
curl --request POST \
  --url https://api.lemlist.com/api/schedules \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Default schedule",
  "secondsToWait": 1200,
  "timezone": "Europe/Paris",
  "start": "09:00",
  "end": "18:00",
  "weekdays": [
    1,
    2,
    3,
    4,
    5
  ],
  "public": false
}'
{
  "_id": "skd_JTb4gjdiizqPoYqzh",
  "name": "Default schedule",
  "secondsToWait": 120,
  "timezone": "Europe/Paris",
  "start": "09:00",
  "end": "18:00",
  "weekdays": [
    1,
    2,
    3,
    4,
    5
  ],
  "public": false,
  "teamId": "tea_Lq4kN7R2pqEA4YFst",
  "createdBy": "usr_n2PG5aHnsGErYS2Yg",
  "createdAt": "2025-01-17T15:17:59.207Z"
}
This endpoint uses the Schedule object.
Creates a new schedule. This endpoint allows setting up schedules with customizable parameters for timing, timezone, and working days.

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
default:Default schedule
required

The name of the schedule

​
timezone
string
default:Europe/Paris
required

Timezone for the schedule (e.g., 'Europe/Paris')

​
start
string
default:09:00
required

Start time in HH:mm format

​
end
string
default:18:00
required

End time in HH:mm format

​
weekdays
integer[]
required

Days of the week the schedule is active (1=Monday, 7=Sunday)

​
secondsToWait
integer
default:1200

Delay in seconds between operations

​
public
boolean
default:false

Set to true to make the schedule visible to use as a template

Response

Schedule successfully created

Sending time windows defining when campaigns can send messages (days and hours).

​
_id
string

Unique schedule identifier

​
name
string

Schedule name

​
secondsToWait
integer

Seconds between sends

​
timezone
string

Schedule timezone (e.g., 'Europe/Paris')

​
start
string

Daily start time (HH:mm)

​
end
string

Daily end time (HH:mm)

​
weekdays
integer[]

Active weekdays (1=Monday, 7=Sunday)

​
public
boolean

Whether the schedule is available as a template for other users

​
teamId
string

Unique identifier of the team that owns this schedule

​
createdBy
string

Unique identifier of the user who created this schedule

​
createdAt
string<date-time>

Timestamp when the schedule was created

​
deletedAt
string<date-time>

Timestamp when the schedule was deleted (only present if deleted)

​
deletedBy
string

Unique identifier of the user who deleted this schedule (only present if deleted)