ScheduleGroups

Creates a schedule group (a division, crew or team).

Requires ManageJobs and an Idempotency-Key header. Same as "New group" on the Schedule Groups page: the group is placed last among its siblings. Add people with PUT /api/v1/schedule-groups/{id}/members/{userId}. Example: { "name": "Install Crew A", "colorHex": "#2e7d32", "parentGroupId": 3 }.

post/api/v1/schedule-groups

Request

  • Base URL: https://app.flexonthejob.com
  • URL: https://app.flexonthejob.com/api/v1/schedule-groups
  • Auth: HTTP bearer

Request body

namestring nullable

Group name, 1–100 characters. Required on create; cannot be cleared. Example: "Install Crew A".

descriptionstring nullable

Optional description shown on the dispatch board, up to 500 characters; "" clears it.

colorHexstring nullable

Colour for calendar / board rendering as 6-digit hex, e.g. "#2e7d32" (the # is optional; stored lower-case); "" clears it.

parentGroupIdinteger nullable

Id of the parent group (e.g. the division a crew belongs to); 0 makes the group top-level. Omit on PATCH to keep the current parent (on create, omitted = top-level). A moved group is placed last among its new siblings; a group cannot be moved under itself or its own descendants.

Response

The new group; Location points at /api/v1/schedule-groups/{id}.

idinteger

Numeric id of the group. Stable within this organization.

syncIdstring uuid

Globally unique sync id (GUID). Use it as the after pagination cursor.

namestring

Group name, e.g. "Install Crew A".

descriptionstring nullable

Optional description shown on the dispatch board.

colorHexstring nullable

Hex colour used for calendar / board rendering, e.g. "#2e7d32"; null when unset.

parentGroupIdinteger nullable

Id of the parent group (e.g. the division a crew belongs to); null for top-level groups.

parentGroupNamestring nullable

Name of the parent group; null for top-level groups.

displayOrderinteger

Sort position among siblings (ascending). Pages are returned in id order, so sort by this client-side when rendering a board.

createdAtstring date-time

UTC creation timestamp.

updatedAtstring date-time nullable

UTC timestamp of the last edit; null when never edited.

Changes

No recorded changes to this operation across all 1 revision of this API.