update_a_person
Modify personnel details in Procore's workforce planning system, including contact information, assignment status, permissions, and employment data for resource management.
Instructions
Update a Person. [Resource Management/Resource Planning] POST /rest/v1.0/workforce-planning/v2/companies/{company_id}/people/{person_id}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company_id | Yes | 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 | Unique identifier for the person | |
| first_name | No | First Name of the Person. | |
| last_name | No | Last Name of the Person. | |
| is_assignable | No | Determines if the Person can be assigned to tasks. | |
| status | No | The status of the Person. `active` means the person is visible in all pages, while `inactive` hides the person unless filtered. Inactive People do not count against billing plans. | |
| group_ids | No | Array of UUIDs representing the Groups this Person belongs to. **Cannot be empty** for an assignable resource or a non-admin Person. | |
| No | The email that the Person will log in with. **Required if updating `is_user` to `true`**. Must be unique across the company. | ||
| permission_level_id | No | UUID of the Permission Level assigned to the Person. **Required when setting `is_user: true`**. | |
| notification_profile_id | No | UUID of the Notification Profile for the user. | |
| phone | No | The Person's phone number, including country and area code. Must be **unique** among all registered People. | |
| can_receive_sms | No | Determines if the Person can receive SMS notifications. | |
| can_receive_email | No | Determines if the Person can receive email notifications. | |
| can_receive_mobile | No | Determines if the Person can receive mobile push notifications if they have the app installed. | |
| address_1 | No | First part of the Person's address. | |
| address_2 | No | Second part of the Person's address (e.g., Apartment, Suite, Unit). | |
| city_town | No | The city or town where the Person is located. | |
| state_province | No | The state or province where the Person is located. | |
| zipcode | No | The postal/zip code of the Person. | |
| country | No | The country where the Person is located. | |
| job_title_id | No | UUID reference to a Job Title in the LaborChart System. | |
| hourly_wage | No | Hourly wage rate for the Person. Used for automatic spend tracking. | |
| employee_number | No | Internal employee identifier. | |
| emergency_contact_name | No | Name of the Person's emergency contact. | |
| emergency_contact_number | No | Phone number of the emergency contact. | |
| emergency_contact_email | No | Email address of the emergency contact. | |
| emergency_contact_relation | No | The relationship between the Person and their emergency contact. | |
| dob | No | Date of birth of the Person. Accepts ISO Date String, UTC Date String, or MS Numeric Epoch Time. | |
| hired_date | No | Date the Person was hired. Accepts ISO Date String, UTC Date String, or MS Numeric Epoch Time. | |
| is_male | No | Specifies if the Person identifies as male. | |
| language | No | Language preference. Currently only `english` is supported. |