Create Time Off For A Person
create_time_off_for_a_personCreate a new time off entry for a person in Procore by specifying company, person, and date range. Returns the created record.
Instructions
Creates a new Time Off entry for a specified Person within a given company. Use this to create a new Resource Planning records in Procore. Creates a new Resource Planning records and returns the created object on success (HTTP 201). Required parameters: company_id, person_id, start_day, end_day. Procore API: Resource Management > Resource Planning. Endpoint: POST /rest/v1.0/workforce-planning/v2/companies/{company_id}/people/{person_id}/time-off
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company_id | Yes | URL path parameter — unique identifier for the company. This parameter accepts both formats: - **Recommended**: Procore company ID (integer) - Use this for new integrations - Legacy: LaborChart UUID format (uuid string... | |
| person_id | Yes | URL path parameter — unique identifier for the person | |
| start_day | Yes | JSON request body field — the start date of the time off. | |
| end_day | Yes | JSON request body field — the end date of the time off. | |
| apply_to_saturday | No | JSON request body field — whether the time off applies to Saturdays. | |
| apply_to_sunday | No | JSON request body field — whether the time off applies to Sundays. | |
| is_paid | No | JSON request body field — whether the time off is paid. | |
| reason | No | JSON request body field — the reason for the time off. | |
| repeat | No | JSON request body field — repeat interval of the time off instances. | |
| batch_start_time | No | JSON request body field — start time of the time off (HH:MM am/pm). | |
| batch_end_time | No | JSON request body field — end time of the time off (HH:MM am/pm). | |
| cadence | No | JSON request body field — cadence of the repeating time off. | |
| repeat_end_day | No | JSON request body field — the end date of the repeating time off. |