Create or update a team
Create a new team or update an existing one. Pass team_id to update.
Restrictions
Usage
- Omit
team_id(or set to 0) to create a new team; pass an existing ID to update. team_namemust be 1–39 characters and unique within the account.- Pass
person_idsto set team membership; this replaces the entire member list. - Pass
emailsorphonesto invite members who don’t yet have accounts. ref_idis an external identifier for integration with third-party HR systems.- Every call is recorded in the account audit log. Don’t put secrets in request fields.
Authorizations
App key issued from the Flashduty console under Account → APP Keys. Required on every public API call. Keep it secret — it grants the same access as the owning account.
Body
Parameters for creating or updating a team.
Team display name. 1–39 characters.
1 - 39Team ID. Omit or set to 0 to create a new team.
Free-form description.
500Member IDs to set as team members. Replaces the existing member list.
Add existing members to the team by email. Addresses that don't match an existing member are silently ignored — no invitation is sent.
Add existing members to the team by phone number. Numbers that don't match an existing member are silently ignored; non-E.164 numbers are parsed with countryCode.
Default country code applied to any phones entries that are not in E.164 format.
External reference ID for HR system integration.
If true and a team with the same name already exists, reset its membership to the provided person_ids.
Response
Success
Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.