Create A Job Title
create_a_job_titleCreate a job title in Procore for a specified company. Set name, group availability, and global access to add a new role to workforce planning.
Instructions
Creates a new Job Title in the specified company. company_id defaults to the value set by procore_set_config when omitted. Creates the job title 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, name, group_ids, globally_accessible. Procore API: Resource Management > Resource Planning. Endpoint: POST /rest/v1.0/workforce-planning/v2/companies/{company_id}/job-titles
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | JSON request body field — the name of the Job Title. | |
| type | No | JSON request body field — indicates whether the Job Title is salaried or hourly. | |
| color | No | JSON request body field — hexadecimal color code for the Job Title. Helps with categorization and visual distinction. | |
| group_ids | Yes | JSON request body field — array of UUIDs for which Groups this Job Title should be available to. If `globally_accessible` is set to `true`, this value can be an empty array. | |
| company_id | Yes | URL path parameter — 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... | |
| hourly_rate | No | JSON request body field — 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 man... | |
| globally_accessible | Yes | JSON request body field — controls whether the Job Title should be globally available to all current and future Groups. |