Pardon our mess These API docs are a work in progress. Endpoints, examples, and behavior may change as we continue to develop the Partner API v2.

Partner API

Set available hours

PUT /api/v2/calendar/hours - Replaces available hours. Accepts available_hours or a raw hours object in the JSON body.

PUT/api/v2/calendar/hours

Replaces available hours. Accepts available_hours or a raw hours object in the JSON body.

Required scope: appointments (or *).

JSON body

NameRequiredDescription
available_hoursYesPer-weekday map: { enabled, start, end } with HH:MM times
curl -s -X PUT -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "available_hours": {
    "mon": {
      "enabled": true,
      "start": "09:00",
      "end": "17:00"
    },
    "tue": {
      "enabled": true,
      "start": "09:00",
      "end": "17:00"
    },
    "wed": {
      "enabled": true,
      "start": "09:00",
      "end": "17:00"
    },
    "thu": {
      "enabled": true,
      "start": "09:00",
      "end": "17:00"
    },
    "fri": {
      "enabled": true,
      "start": "09:00",
      "end": "16:00"
    },
    "sat": {
      "enabled": false,
      "start": "09:00",
      "end": "17:00"
    },
    "sun": {
      "enabled": false,
      "start": "09:00",
      "end": "17:00"
    }
  }
}' \
  "https://benefitpath.com/api/v2/calendar/hours"
{
  "success": true,
  "timezone": "America/New_York",
  "available_hours": {
    "mon": { "enabled": true, "start": "09:00", "end": "17:00" },
    "tue": { "enabled": true, "start": "09:00", "end": "17:00" },
    "wed": { "enabled": true, "start": "09:00", "end": "17:00" },
    "thu": { "enabled": true, "start": "09:00", "end": "17:00" },
    "fri": { "enabled": true, "start": "09:00", "end": "16:00" },
    "sat": { "enabled": false, "start": "09:00", "end": "17:00" },
    "sun": { "enabled": false, "start": "09:00", "end": "17:00" }
  }
}

See Errors for the standard error envelope and rate limits.