POST /rest/v1.0/workforce-planning/v2/companies/{company_id}/groups

Creates a single Group

Servers

Path parameters

Name Type Required Description
company_id Yes

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) - Supported for backward compatibility

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
contact_email String No

Email address for the Group's Point of Contact.

timezone String Yes

The default Timezone for scheduling outbound messages from projects in this group that don't specify their own Timezone. Example format: America/Chicago.

name String Yes

Group Name.

state_province String No

The State or Province for the Group.

contact_name String No

The Point of Contact (P.O.C.) name for the Group.

address_1 String No

The first part of the Group's address.

city_town String No

The City or Town for the Group.

address_2 String No

The second part of the Group's address (e.g., Apartment, Suite, Unit).

country String No

The Country for the Group.

zipcode String No

Zip or Postal Code for the Group.

color String No

Hexadecimal color code for the Group. Can be helpful for categorization. Example: #53A9FF.

contact_phone String No

Phone number for the Group's Point of Contact. Must include country and area code.

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.