Skip to main content
POST
Create Schedule
This endpoint uses the Schedule object.

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

Pattern: ^([01]\d|2[0-3]):[0-5]\d$
end
string
default:18:00
required

End time in HH:mm format

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

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

Required range: 1 <= x <= 7
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)

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)