Update A Single Group
update_a_single_groupUpdate a specific Procore group by providing its ID, company ID, and required details like name and timezone. Returns the updated group or an HTTP error for invalid credentials, permissions, or IDs.
Instructions
Update the single Group in a given ID and body. company_id defaults to the value set by procore_set_config when omitted, and group_id must identify an existing parent record — resolve it with the matching list tool first. Applies the change and returns the updated group. 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, group_id, name, timezone. Procore API: Resource Management > Resource Planning. Endpoint: POST /rest/v1.0/workforce-planning/v2/companies/{company_id}/groups/{group_id}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | JSON request body field — group Name. | |
| color | No | JSON request body field — hexadecimal color code for the Group. Can be helpful for categorization. Example: #53A9FF. | |
| country | No | JSON request body field — the Country for the Group. | |
| zipcode | No | JSON request body field — zip or Postal Code for the Group. | |
| group_id | Yes | URL path parameter — unique identifier for the group | |
| timezone | Yes | JSON request body field — the default Timezone for scheduling outbound messages from projects in this group that don't specify their own Timezone. Example format: America/Chicago. | |
| address_1 | No | JSON request body field — the first part of the Group's address. | |
| address_2 | No | JSON request body field — the second part of the Group's address (e.g., Apartment, Suite, Unit). | |
| city_town | No | JSON request body field — the City or Town for the Group. | |
| 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... | |
| contact_name | No | JSON request body field — the Point of Contact (P.O.C.) name for the Group. | |
| contact_email | No | JSON request body field — email address for the Group's Point of Contact. | |
| contact_phone | No | JSON request body field — phone number for the Group's Point of Contact. Must include country and area code. | |
| state_province | No | JSON request body field — the State or Province for the Group. |