POST
/
schedules
Create a schedule
curl --request POST \
  --url https://api.reply.io/v3/schedules \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "id": "schedule-123",
  "name": "Business Hours Schedule",
  "schedule": {
    "startDate": "2025-07-01T08:00:00Z",
    "endDate": "2025-12-31T23:59:59Z",
    "timezone": "Europe/Warsaw",
    "workingWindows": [
      {
        "days": [
          1,
          2,
          3,
          4
        ],
        "from": "09:00",
        "to": "17:00"
      },
      {
        "days": [
          5
        ],
        "from": "10:00",
        "to": "18:00"
      }
    ]
  },
  "useContactTimezone": false,
  "skipPublicHolidays": true,
  "publicHolidayRegion": "US",
  "isDefault": true,
  "isActive": true,
  "createdAt": "2024-03-08T14:30:00Z",
  "updatedAt": "2025-06-18T09:21:12Z"
}'
{
  "id": "schedule-123",
  "name": "Business Hours Schedule",
  "schedule": {
    "startDate": "2025-07-01T08:00:00Z",
    "endDate": "2025-12-31T23:59:59Z",
    "timezone": "Europe/Warsaw",
    "workingWindows": [
      {
        "days": [
          1,
          2,
          3,
          4
        ],
        "from": "09:00",
        "to": "17:00"
      },
      {
        "days": [
          5
        ],
        "from": "10:00",
        "to": "18:00"
      }
    ]
  },
  "useContactTimezone": false,
  "skipPublicHolidays": true,
  "publicHolidayRegion": "US",
  "isDefault": true,
  "isActive": true,
  "createdAt": "2024-03-08T14:30:00Z",
  "updatedAt": "2025-06-18T09:21:12Z"
}

Authorizations

X-API-Key
string
header
required

API key passed in the X-API-Key header

Body

application/json
name
string
required

Human-readable schedule name

schedule
object
required

Schedule configuration for sending messages

id
string

Unique identifier for the schedule

useContactTimezone
boolean

Send in each prospect's own time-zone when available

skipPublicHolidays
boolean

Do not send on public holidays in publicHolidayRegion

publicHolidayRegion
string

ISO-3166-1 alpha-2 code (e.g. 'US'). Required when skipPublicHolidays = true

isDefault
boolean

Auto-selected when a sequence has no explicit schedule

isActive
boolean

Disabled schedules are ignored by send engines

createdAt
string<date-time>

ISO-8601 UTC timestamp when created

updatedAt
string<date-time>

ISO-8601 UTC timestamp of last update

Response

201 - application/json

Schedule created successfully

name
string
required

Human-readable schedule name

schedule
object
required

Schedule configuration for sending messages

id
string

Unique identifier for the schedule

useContactTimezone
boolean

Send in each prospect's own time-zone when available

skipPublicHolidays
boolean

Do not send on public holidays in publicHolidayRegion

publicHolidayRegion
string

ISO-3166-1 alpha-2 code (e.g. 'US'). Required when skipPublicHolidays = true

isDefault
boolean

Auto-selected when a sequence has no explicit schedule

isActive
boolean

Disabled schedules are ignored by send engines

createdAt
string<date-time>

ISO-8601 UTC timestamp when created

updatedAt
string<date-time>

ISO-8601 UTC timestamp of last update