PUT
/
v3
/
schedulers
/
{id}
Update a scheduler
curl --request PUT \
  --url https://api.reply.io/v3/schedulers/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "name": "Updated business hours",
  "timezoneId": "America/Chicago",
  "excludeHolidays": true,
  "useProspectTimezone": false,
  "useFollowUpSchedule": true,
  "mainTimings": [
    {
      "weekDay": "Monday",
      "isActive": true,
      "timeRanges": [
        {
          "fromTime": {
            "hour": 9,
            "minute": 0
          },
          "toTime": {
            "hour": 12,
            "minute": 0
          }
        }
      ]
    }
  ],
  "followUpTimings": [
    {
      "weekDay": "Monday",
      "isActive": true,
      "timeRanges": [
        {
          "fromTime": {
            "hour": 14,
            "minute": 0
          },
          "toTime": {
            "hour": 17,
            "minute": 0
          }
        }
      ]
    }
  ]
}
'
{
  "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"
}

Authorizations

X-API-Key
string
header
required

API key passed in the X-API-Key header

Path Parameters

id
integer
required

Scheduler ID

Body

application/json

Request body for updating an existing scheduler.

name
string
required

Name of the scheduler

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 scheduler 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

Scheduler updated successfully

Full representation of a scheduler with timing configuration.

id
integer

Unique identifier for the scheduler

name
string

Name of the scheduler

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 scheduler 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

Whether this is the default scheduler

status
string

Current status of the scheduler