Create Permission Template
create_permission_templateCreate a Procore permission template to define permissions and user access levels for company or project tools. Returns the created template and its ID.
Instructions
Returns the created Permission Template along with its permitted actions. Pass the record's fields as top-level arguments — they are nested under "permission_template" in the request payload for you. company_id defaults to the value set by procore_set_config when omitted. Creates the permission template 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. Procore API: Core > Directory. Endpoint: POST /rest/v1.0/companies/{company_id}/permission_templates
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | JSON request body field — the ID of the Permission Template | |
| name | No | JSON request body field — the name of the Permission Template | |
| type | No | JSON request body field — 'company_tools', 'global' or 'project_specific' | |
| category | No | JSON request body field — the category of the Permission Template | |
| company_id | Yes | URL path parameter — unique identifier for the company. | |
| project_id | No | JSON request body field — id of corresponding project if provider_type == Project | |
| permissions | No | JSON request body field — permitted actions for active tools | |
| provider_id | No | JSON request body field — either the company_id or project_id based on provider_type | |
| provider_type | No | JSON request body field — 'Project' or 'Company' | |
| user_access_levels | No | JSON request body field — user access levels for active tools |