Calendar: Sources

Base URL: $BUSINESS_API

List calendar import sources

Logs

GET /calendar/sources

Lists the configured calendar sources of the tenant in a data array without pagination. A source records where holiday data comes from (manual, file, url, connector or template_version), its reference, refresh schedule, whether imports from it apply automatically, and whether it is enabled. Requires automations:read.

Parameters

limitinteger · query · optional

Maximum resources to return (default 20, maximum 100).

afterstring · query · optional

Opaque cursor returned by the previous page.

Returns

200 Sources

Permissions automations:read · Roles: admin, analyst, customer_service, finance, operations, owner

curl -X GET "$BUSINESS_API/calendar/sources" \
  -H "Authorization: Bearer sk_test_..."
Response 200

Sources

Add a calendar import source

Logs

POST /calendar/sources

Registers a calendar source and returns it with 201. kind must be manual, file, url, connector or template_version; the source is enabled unless enabled is false. Imports created with this source's id track which days and rules came from it, so later imports can report what the source removed. Requires automations:write.

Body application/json

kindstring · required

one of manual, file, url, connector, template_version

referencestring · optional
refresh_schedulestring · optional
auto_applyboolean · optional
enabledboolean · optional

Returns

201 Created source

Permissions automations:write · Roles: admin, finance, operations, owner

curl -X POST "$BUSINESS_API/calendar/sources" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "manual",
  "reference": "REF-2026-000142",
  "refresh_schedule": "refresh schedule",
  "auto_apply": true,
  "enabled": true
}'
Response 201

Created source

Update fields of a calendar import source

Logs

PATCH /calendar/sources/{id}

Changes only the fields sent on a calendar source and returns it. Disabling a source makes new imports and applies that reference it fail with 400. An invalid kind returns 400 and an unknown id returns 404. Requires automations:write.

Parameters

idstring · path · required

Id of the calendar source to update (prefix csr).

Body application/json

kindstring · optional

one of manual, file, url, connector, template_version

referencestring · optional
refresh_schedulestring · optional
auto_applyboolean · optional
enabledboolean · optional

Returns

200 Updated source

Errors 404

Permissions automations:write · Roles: admin, finance, operations, owner

curl -X PATCH "$BUSINESS_API/calendar/sources/{id}" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "manual",
  "reference": "REF-2026-000142",
  "refresh_schedule": "refresh schedule",
  "auto_apply": true,
  "enabled": true
}'
Response 200

Updated source

Remove a calendar import source

Logs

DELETE /calendar/sources/{id}

Deletes a calendar source and returns 204 with no body. Days and rules already imported from it stay in the calendar. Returns 404 when the source is not in this tenant. Requires automations:write.

Parameters

idstring · path · required

Id of the calendar source to delete (prefix csr).

Returns

204 Deleted

Permissions automations:write · Roles: admin, finance, operations, owner

curl -X DELETE "$BUSINESS_API/calendar/sources/{id}" \
  -H "Authorization: Bearer sk_test_..."
Response 204

Deleted