Skip to main content
POST
Creates a new leave request in your COR instance through the integrations service. The user and leave type must have been previously created through the integrations API.

Request Body Requirements

object
required
string
required
External leave request ID from your source system
string
required
External user ID. The user must have been previously created through the integrations API.
string
required
External leave type ID. The leave type must have been previously created through the integrations API.
string
required
Start date and time in ISO 8601 format (e.g., “2026-05-11T00:00:00-00:00”)
string
required
End date and time in ISO 8601 format (e.g., “2026-05-11T23:59:00-00:00”)
boolean
required
Whether the leave is for the entire day. When true, the time portion is typically ignored.

Known Errors

  • ValidationError — Missing required fields
  • UserNotFoundError — The specified user does not exist in the integration mappings
  • LeaveTypeNotFoundError — The specified leave type does not exist in the integration mappings
  • InvalidDateRangeError — End date must be after or equal to start date
  • DuplicateExternalIdError — A leave request with this external ID already exists for this source