POST /rest/v1.0/projects/{project_id}/users

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

Servers

Path parameters

Name Type Required Description
project_id Integer Yes

Unique identifier for the project.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Procore-Company-Id Integer Yes

Unique company identifier associated with the Procore User Account.

Query parameters

Name Type Required Description
run_configurable_validations Boolean No

If true, validations are run for the corresponding Configurable Field Set.

Default value: false

Request body fields

Name Type Required Description
user Object Yes
user.business_phone_extension Integer No

The Business Phone Extension of the Project User

user.job_title String No

The Job Title of the Project User

user.mobile_phone String No

The Mobile Phone number of the Project User

user.vendor_id Integer No

The Vendor ID of the Project User

user.email_address String Yes

The Email Address of the Project User

user.fax_number String No

The Fax Number of the Project User

user.first_name String No

The First Name of the Project User

user.is_active Boolean No

The Active status of the Project User

user.is_employee Boolean No

The Employee status of the Project User

Default value: false

user.country_code String No

The Country Code of the Project User (ISO-3166 Alpha-2 format)

user.initials String No

The Initials of the Project User

user.city String No

The City in which the Project User resides

user.last_name String Yes

The Last Name of the Project User

user.notes String No

The Notes (notes/keywords/tags) of the Project User

user.email_signature String No

The Email Signature of the Project User

user.state_code String No

The State Code of the Project User (ISO-3166 Alpha-2 format)

user.zip String No

The Zip Code of the Project User

user.business_phone String No

The Business Phone number of the Project User

user.employee_id String No

The Employee ID of the Project User

user.permission_template_id Integer No

The Permission Template ID of the Project User

user.avatar String No

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.

user.address String No

The street Address of the Project User

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.