Skip to main content
POST
/
v3
/
schedules
Create a schedule
curl --request POST \
  --url https://api.reply.io/v3/schedules \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Evening outreach",
  "timezoneId": "Europe/London",
  "excludeHolidays": false,
  "useProspectTimezone": true,
  "useFollowUpSchedule": false,
  "mainTimings": [
    {
      "weekDay": "Monday",
      "isActive": true,
      "timeRanges": [
        {
          "fromTime": {
            "hour": 18,
            "minute": 0
          },
          "toTime": {
            "hour": 21,
            "minute": 0
          }
        }
      ]
    }
  ],
  "followUpTimings": []
}
'
{
  "id": 1,
  "name": "Business hours",
  "timezoneId": "America/New_York",
  "excludeHolidays": true,
  "useProspectTimezone": false,
  "useFollowUpSchedule": false,
  "mainTimings": [
    {
      "weekDay": "Monday",
      "isActive": true,
      "timeRanges": [
        {
          "fromTime": {
            "hour": 9,
            "minute": 0
          },
          "toTime": {
            "hour": 17,
            "minute": 0
          }
        }
      ]
    }
  ],
  "followUpTimings": [],
  "isDefault": true,
  "status": "active"
}

Documentation Index

Fetch the complete documentation index at: https://docs.reply.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Authorization: Bearer <your-api-key>

Get your API key from the Reply dashboard: Settings → API Key.

Body

application/json

Request body for creating a new schedule.

name
string
required

Name of the schedule

timezoneId
string
required

IANA timezone identifier (e.g., "America/New_York")

excludeHolidays
boolean

Whether to skip sending on holidays from linked calendars

useProspectTimezone
boolean

Whether to use the prospect's timezone instead of the schedule timezone

useFollowUpSchedule
boolean

Whether a separate follow-up schedule is enabled

mainTimings
ScheduleTiming · object[]

Primary schedule timings for each day of the week

followUpTimings
ScheduleTiming · object[]

Follow-up schedule timings (used when useFollowUpSchedule is true)

Response

Schedule created successfully

Full representation of a schedule with timing configuration.

id
integer
read-only

Unique identifier for the schedule

name
string

Name of the schedule

timezoneId
string

IANA timezone identifier (e.g., "America/New_York")

excludeHolidays
boolean

Whether to skip sending on holidays from linked calendars

useProspectTimezone
boolean

Whether to use the prospect's timezone instead of the schedule timezone

useFollowUpSchedule
boolean

Whether a separate follow-up schedule is enabled

mainTimings
ScheduleTiming · object[]

Primary schedule timings for each day of the week

followUpTimings
ScheduleTiming · object[]

Follow-up schedule timings (used when useFollowUpSchedule is true)

isDefault
boolean
read-only

Whether this is the default schedule

status
string
read-only

Current status of the schedule