Skip to main content
PUT
/
api
/
organizations
/
{organizationId}
/
business-hours
Update organization business hours configuration
curl --request PUT \
  --url https://your-instance.example.com/api/organizations/{organizationId}/business-hours \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "timezone": "America/New_York",
  "businessHours": {
    "monday": {
      "enabled": true,
      "start": "09:00",
      "end": "17:00"
    },
    "tuesday": {
      "enabled": true,
      "start": "09:00",
      "end": "17:00"
    },
    "wednesday": {
      "enabled": true,
      "start": "09:00",
      "end": "17:00"
    },
    "thursday": {
      "enabled": true,
      "start": "09:00",
      "end": "17:00"
    },
    "friday": {
      "enabled": true,
      "start": "09:00",
      "end": "15:00"
    }
  },
  "holidays": [
    {
      "date": "2026-12-25",
      "label": "Christmas Day"
    }
  ],
  "exceptionalHours": [],
  "allowUserBusinessHoursOverride": false
}
'
{
  "success": true,
  "data": {
    "timezone": "America/New_York",
    "businessHours": {
      "monday": {
        "enabled": true,
        "start": "09:00",
        "end": "17:00"
      }
    },
    "holidays": [
      {
        "date": "2026-12-25",
        "label": "Christmas Day"
      }
    ],
    "exceptionalHours": [],
    "allowUserBusinessHoursOverride": false
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
organizationId
string
required

Body

application/json
​
timezone
string

IANA timezone (e.g. America/New_York)

​
businessHours
object | null

Weekly schedule keyed by lowercase day name; pass null to clear.

Example:
{
  "monday": {
    "enabled": true,
    "start": "09:00",
    "end": "17:00"
  },
  "tuesday": {
    "enabled": true,
    "start": "09:00",
    "end": "17:00"
  },
  "wednesday": {
    "enabled": true,
    "start": "09:00",
    "end": "17:00"
  },
  "thursday": {
    "enabled": true,
    "start": "09:00",
    "end": "17:00"
  },
  "friday": {
    "enabled": true,
    "start": "09:00",
    "end": "17:00"
  },
  "saturday": {
    "enabled": false,
    "start": "09:00",
    "end": "17:00"
  },
  "sunday": {
    "enabled": false,
    "start": "09:00",
    "end": "17:00"
  }
}
​
holidays
object[]
Maximum array length: 200
​
exceptionalHours
object[]
Maximum array length: 200
​
allowUserBusinessHoursOverride
boolean

Response

Business hours updated

​
success
enum<boolean>
Available options:
true
​
data
object
Example:
{
  "timezone": "America/New_York",
  "businessHours": {
    "monday": {
      "enabled": true,
      "start": "09:00",
      "end": "17:00"
    },
    "friday": {
      "enabled": true,
      "start": "09:00",
      "end": "15:00"
    }
  },
  "holidays": [
    {
      "date": "2026-12-25",
      "label": "Christmas Day"
    }
  ],
  "exceptionalHours": [
    {
      "date": "2026-12-24",
      "closed": false,
      "start": "09:00",
      "end": "13:00",
      "label": "Christmas Eve"
    }
  ],
  "allowUserBusinessHoursOverride": false
}