Create Project User
create_project_userCreate a new user in a specified Procore project using project ID, email address, and last name. The API returns the created user with its new ID.
Instructions
Creates a new user in the specified project. #### Country and State codes The country_code and state_code parameter values must conform to the ISO-3166 Alpha-2 specification. See Working with Country Codes for additional information. #### Created Response For null values, the key won't be returned. Pass the record's fields as top-level arguments — they are nested under "user" in the request payload for you. project_id defaults to the value set by procore_set_config when omitted. Creates the project user 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: project_id, email_address, last_name. Procore API: Core > Directory. Endpoint: POST /rest/v1.0/projects/{project_id}/users
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zip | No | JSON request body field — the Zip Code of the Project User | |
| city | No | JSON request body field — the City in which the Project User resides | |
| notes | No | JSON request body field — the Notes (notes/keywords/tags) of the Project User | |
| avatar | No | JSON request body field — project User Avatar. To upload avatar you must upload whole payload as `multipart/form-data` content-type and specify each parameter as form-data together with `user[avatar]` as file. | |
| address | No | JSON request body field — the street Address of the Project User | |
| initials | No | JSON request body field — the Initials of the Project User | |
| is_active | No | JSON request body field — the Active status of the Project User | |
| job_title | No | JSON request body field — the Job Title of the Project User | |
| last_name | Yes | JSON request body field — the Last Name of the Project User | |
| vendor_id | No | JSON request body field — the Vendor ID of the Project User | |
| fax_number | No | JSON request body field — the Fax Number of the Project User | |
| first_name | No | JSON request body field — the First Name of the Project User | |
| project_id | Yes | URL path parameter — unique identifier for the project. | |
| state_code | No | JSON request body field — the State Code of the Project User (ISO-3166 Alpha-2 format) | |
| employee_id | No | JSON request body field — the Employee ID of the Project User | |
| is_employee | No | JSON request body field — the Employee status of the Project User | |
| country_code | No | JSON request body field — the Country Code of the Project User (ISO-3166 Alpha-2 format) | |
| mobile_phone | No | JSON request body field — the Mobile Phone number of the Project User | |
| email_address | Yes | JSON request body field — the Email Address of the Project User | |
| business_phone | No | JSON request body field — the Business Phone number of the Project User | |
| email_signature | No | JSON request body field — the Email Signature of the Project User | |
| permission_template_id | No | JSON request body field — the Permission Template ID of the Project User | |
| business_phone_extension | No | JSON request body field — the Business Phone Extension of the Project User | |
| run_configurable_validations | No | Query string parameter — if true, validations are run for the corresponding Configurable Field Set. |