Group Management endpoints

You can now manage groups programmatically through the Public API. Previously, groups could only be created and maintained from the web dashboard — group administration can now be fully automated alongside your existing user and timesheet integrations.

What's new

Create, update, and delete groups

• POST /groups — Create a group, optionally assigning members at creation.
• PUT /groups/{groupId} — Update a group's name and/or replace its full membership.
• DELETE /groups/{groupId} — Delete a single group.
• DELETE /groups — Delete multiple groups in one request.

Manage group membership

• POST /groups/{groupId}/members — Add users to a group without affecting existing members.
• DELETE /groups/{groupId}/members — Remove specific users from a group.

Things to know

• Unique names — Group names must be unique within your company.
• Job assignments — Adding a user to a group also grants them the group's job assignments. Removing a user from a group leaves their job assignments intact, since a job may be granted through another group or directly.
• Company-scoped — All requests are automatically scoped to the company tied to your API token, and any user_ids or group_ids you pass must belong to your company.

See the Groups section of the API Reference for request and response details.