Get Campaign Schedules

Retrieves all schedules associated with a specific campaign.

GET /campaigns/{campaignId}/schedules

Get Campaign Schedules

cURL

curl --request GET \
  --url https://api.lemlist.com/api/campaigns/{campaignId}/schedules/ \
  --header 'Authorization: Basic <encoded-value>'

200

[
  {
    "_id": "skd_dI6LDboHxORcW2quf",
    "name": "Test 2",
    "secondsToWait": 1200,
    "timezone": "Atlantic/Reykjavik",
    "start": "08:00",
    "end": "18:00",
    "weekdays": [
      1,
      2,
      3,
      4,
      5
    ],
    "teamId": "tea_HpxHgbqZR5p7jPodG",
    "createdBy": "usr_gbY1wCFnSHq5ubnyG",
    "createdAt": "2025-02-06T16:29:10.217Z"
  },
  {
    "_id": "skd_shtm9OHLWbGkro94C",
    "name": "Default schedule",
    "secondsToWait": 1200,
    "timezone": "Africa/Ceuta",
    "start": "09:00",
    "end": "18:00",
    "weekdays": [
      1,
      2,
      3,
      4,
      5
    ],
    "teamId": "tea_HpxHgbqZR5p7jPodG",
    "createdBy": "usr_z7biYanHn06hmOlXs",
    "createdAt": "2025-02-06T15:36:01.531Z"
  },
  {
    "_id": "skd_R90npZ8YWo0QqjO3u",
    "name": "Default schedule",
    "secondsToWait": 1200,
    "timezone": "Europe/Paris",
    "start": "09:00",
    "end": "18:00",
    "weekdays": [
      1,
      2,
      3,
      4,
      5
    ],
    "teamId": "tea_HpxHgbqZR5p7jPodG",
    "createdBy": "usr_z7biYanHn06hmOlXs",
    "createdAt": "2025-02-06T15:35:52.079Z"
  }
]

This endpoint uses the Schedule object.

The campaign is identified by the campaignId provided in the URL path, and it must belong to your team.

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

campaignId · string · required

The unique identifier of the campaign

Response

200

application/json

Success

_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)

Pattern: ^([01]\d|2[0-3]):[0-5]\d$

end · string

Daily end time (HH:mm)

Pattern: ^([01]\d|2[0-3]):[0-5]\d$

weekdays · integer[]

Active weekdays (1=Monday, 7=Sunday)

Required range: 1 <= x <= 7

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)