Create Company Person
create_company_personCreate a new company person in Procore by providing company_id and last_name. It returns the created person with its new id or an error payload with HTTP status.
Instructions
Create a new Company Person. Pass the record's fields as top-level arguments — they are nested under "person" in the request payload for you. company_id defaults to the value set by procore_set_config when omitted. Creates the company person and returns it with its new id (HTTP 201); calling it again creates another record. Failures come back as an error payload carrying the HTTP status — commonly 401 when the token has expired, 403 without tool permission, and 404 when an id does not resolve. Required parameters: company_id, last_name. Procore API: Core > Directory. Endpoint: POST /rest/v1.0/companies/{company_id}/people
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| view | No | Query string parameter — specifies which view of the resource to return (which attributes should be present in the response). If a valid view is not provided, it will default to normal. | |
| active | No | JSON request body field — the active status of the Company Person | |
| job_title | No | JSON request body field — the Job Title of the Company Person | |
| last_name | Yes | JSON request body field — the Last Name of the Company Person | |
| origin_id | No | JSON request body field — the Origin ID of the Company User | |
| company_id | Yes | URL path parameter — unique identifier for the Procore company | |
| first_name | No | JSON request body field — the First Name of the Company Person | |
| employee_id | No | JSON request body field — the Employee ID of the Company Person | |
| is_employee | No | JSON request body field — the Employee status of the Company Person | |
| work_classification_id | No | JSON request body field — the unique identifier for the work classification of the Company Person. |