FAfactorialhr
Timeoff > PolicyAssignment

Creates a Policy assignment

Changed on

Create a Time off Policy Assignment

post/api/2026-10-01/resources/timeoff/policy_assignments

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/timeoff/policy_assignments
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: time_off
    • or API key in header x-api-key

Request body

timeoff_policy_idstring required

The time off policy id

employee_idstring required

The employee id

effective_atstring required

The effective date of the policy assignment

Example request

{
  "timeoff_policy_id": "1",
  "employee_id": "1",
  "effective_at": "2024-01-01"
}

Response

CREATED

idstring

Unique identifier of the policy assignment

timeoff_policy_idstring required

ID of the time off policy assigned to the employee

employee_idstring required

ID of the employee this assignment governs

effective_atstring required

Date from which this policy assignment takes effect for the employee

Example response

{
  "id": "1",
  "timeoff_policy_id": "1",
  "employee_id": "1",
  "effective_at": "2024-01-01"
}

Changes