Skip to main content
PATCH
/
schedules
/
{scheduleId}
Update Schedule
curl --request PATCH \
  --url https://api.lemlist.com/api/schedules/{scheduleId} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Schedule new name"
}'
{
  "_id": "skd_AEcaBR4KvwvFtFhyH",
  "name": "Renamed Schedule",
  "secondsToWait": 1000,
  "timezone": "Europe/Berlin",
  "start": "08:00",
  "end": "18:00",
  "weekdays": [
    1,
    2,
    3,
    2,
    5
  ],
  "public": true,
  "teamId": "tea_b4rMsi2trB42WyuWP",
  "createdBy": "usr_gmHgNGRcGPSTJrDbT",
  "createdAt": "2025-10-27T09:41:11.187Z"
}
This endpoint uses the Schedule object.
Updates an existing schedule with new parameters.

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

​
scheduleId
string
required

The unique identifier of the schedule

Body

application/json
​
name
string

The name of the schedule

​
secondsToWait
integer

Delay in seconds between operations

​
timezone
string

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

​
start
string

Start time in HH:mm format

​
end
string

End time in HH:mm format

​
weekdays
integer[]

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

​
public
boolean

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

Response

Schedule successfully updated

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)