POST /rest/v1.0/workforce-planning/v2/companies/{company_id}/job-titles
Creates a new Job Title in the specified company.
Servers
- https://api.procore.com
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
company_id |
Yes |
Unique identifier for the company. This parameter accepts both formats:
A proxy layer automatically handles both formats, but using the Procore company ID is preferred for consistency with other Procore APIs. |
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. |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
name |
String | Yes |
The name of the Job Title. |
globally_accessible |
Boolean | Yes |
Controls whether the Job Title should be globally available to all current and future Groups. |
type |
String | No |
Indicates whether the Job Title is salaried or hourly. Possible values:
|
hourly_rate |
Number | No |
The rate value that will be factored into cost calculations for any person who has this job title applied and doesn't already have a standalone hourly wage value. This is also handy for costing manpower requests when job titles are specified. |
group_ids[] |
Array | Yes |
Array of UUIDs for which Groups this Job Title should be available to. If |
color |
String | No |
Hexadecimal color code for the Job Title. Helps with categorization and visual distinction. |
How to start integrating
- Add HTTP Task to your workflow definition.
- 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.
- Click Test request to test run your request to the API and see the API's response.