Webhook events and payloads - 16TMS Integration Guide

This page lists all webhook events and the exact payload sent to your endpoint when using the default payload format. Use it to integrate with 16Arena webhooks. For the HTTP contract, data key mapping, full allow-list of event types, and integration checklist, see the Webhook developer guide.

Delivery details

Method: POST
Content-Type: application/json
Body: JSON (camelCase). Null fields are omitted.
Signature (optional): If you set a Secret Key on the webhook, each request includes header:
- X-Webhook-Signature: sha256=<hex> (HMAC-SHA256 of the raw JSON body).

Default payload envelope (all events)

Every webhook uses this top-level structure. Only data varies by event.

{
  "event": "<event-type>",
  "eventId": "<uuid>",
  "timestamp": "<ISO 8601>",
  "tenantId": "<uuid>",
  "data": { ... }
}

Field	Type	Description
`event`	string	Event type (e.g. `team.member.joined`)
`eventId`	string	Unique id for this delivery (idempotency)
`timestamp`	string	When the event occurred (ISO 8601)
`tenantId`	string	Your tenant ID
`data`	object	Event-specific data (see per-event)

Event reference (all event types)

Use the list below to jump to a specific event. Events are grouped by category; the sidebar shows the same structure. Team

team.member.joined — User added to team
team.member.removed — User removed from team

Tournament joining

tournament.player.joined — Player joined tournament
tournament.team.joined — Team joined tournament

Assignments & Placements

participant.assigned.round — Participant assigned to a round
participant.assigned.group — Participant assigned to a group
participant.assigned.match — Participant assigned to a match
participant.removed.round — Participant removed from a round
participant.removed.group — Participant removed from a group
participant.removed.match — Participant removed from a match

Match Lifecycle

match.created — Match created
match.updated — Match updated

Tournaments

tournament.published — Tournament published
tournament.rules.updated — Tournament rules updated
tournament.points.updated — Tournament points system updated

Match announcements

id.pass.announcement — Room ID and credentials for a match
match.announcement — Announcement to a match

Tournament-related announcements

group.announcement — Announcement to a group
round.announcement — Announcement to a round
tournament.announcement — Tournament-wide announcement

Team

team.member.joined

When: A user is added to a team. Payload data:

Field	Type	Description
`teamId`	string	UUID of the team
`teamName`	string	Team display name
`userId`	string	UUID of the user
`userName`	string	User display name

Example data:

{
  "teamId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "teamName": "Alpha Squad",
  "userId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "userName": "PlayerOne"
}

team.member.removed

When: A user is removed from a team. Payload data: Same as team.member.joined.

Field	Type	Description
`teamId`	string	UUID of the team
`teamName`	string	Team display name
`userId`	string	UUID of the user
`userName`	string	User display name

Tournament joining

tournament.player.joined

When: A player (individual) is approved/joined to a tournament. Payload data:

Field	Type	Description
`tournamentId`	string	UUID of the tournament
`participantId`	string	UUID of the player
`participantType`	string	`"Player"`
`registrationId`	string	UUID of the registration
`registrationStatus`	string	e.g. `"Approved"`

Example data:

{
  "tournamentId": "t1t2t3t4-t5t6-7890-tour-nament1234567",
  "participantId": "p1p2p3p4-p5p6-7890-play-er1234567890",
  "participantType": "Player",
  "registrationId": "r1r2r3r4-r5r6-7890-reg-istration12345",
  "registrationStatus": "Approved"
}

tournament.team.joined

When: A team is approved/joined to a tournament. Payload data: Same structure as tournament.player.joined; participantType is "Team".

Field	Type	Description
`tournamentId`	string	UUID of the tournament
`participantId`	string	UUID of the team
`participantType`	string	`"Team"`
`registrationId`	string	UUID of the registration
`registrationStatus`	string	e.g. `"Approved"`

Assignments & Placements

Assignment and removal webhooks are scoped by context. Subscribe to participant.assigned.* / participant.removed.* for the round, group, or match flows you care about.

participant.assigned.round

When: Participants are assigned to a round (for example bracket slots). Payload data:

Field	Type	Description
`tournamentId`	string	UUID of the tournament
`roundId`	string	UUID of the round
`roundName`	string	Round display name
`participantIds`	array	UUIDs of assigned participants
`participantType`	string	`"User"` or `"Team"`

Example data:

{
  "tournamentId": "22222222-2222-2222-2222-222222222222",
  "roundId": "55555555-5555-5555-5555-555555555555",
  "roundName": "Round 1",
  "participantIds": [
    "66666666-6666-6666-6666-666666666666",
    "77777777-7777-7777-7777-777777777777"
  ],
  "participantType": "Team"
}

participant.assigned.group

When: Participants are assigned to a group (for example within a round). Payload data:

Field	Type	Description
`tournamentId`	string	UUID of the tournament
`roundId`	string	UUID of the parent round
`roundName`	string	Round display name
`groupId`	string	UUID of the group
`groupName`	string	Group display name
`participantIds`	array	UUIDs of assigned participants
`participantType`	string	`"User"` or `"Team"`

Example data:

{
  "tournamentId": "22222222-2222-2222-2222-222222222222",
  "groupId": "88888888-8888-8888-8888-888888888888",
  "groupName": "Group A",
  "roundId": "55555555-5555-5555-5555-555555555555",
  "roundName": "Round 1",
  "participantIds": [
    "66666666-6666-6666-6666-666666666666"
  ],
  "participantType": "User"
}

participant.assigned.match

When: Participants are assigned to a match. Payload data:

Field	Type	Description
`tournamentId`	string	UUID of the tournament
`roundId`	string	UUID of the round (if any)
`matchId`	string	UUID of the match
`participantIds`	array	UUIDs of assigned participants (may be omitted until the match tracks them)
`participantType`	string	`"User"` or `"Team"`
`status`	string	Match type or status

Example data:

{
  "matchId": "33333333-3333-3333-3333-333333333333",
  "tournamentId": "22222222-2222-2222-2222-222222222222",
  "roundId": "55555555-5555-5555-5555-555555555555",
  "status": "Duel"
}

participant.removed.round

When: A participant is removed from a round. Payload data: Same fields as participant.assigned.round (tournamentId, roundId, roundName, participantIds, participantType). Example data:

{
  "tournamentId": "22222222-2222-2222-2222-222222222222",
  "roundId": "55555555-5555-5555-5555-555555555555",
  "roundName": "Round 1",
  "participantIds": [
    "66666666-6666-6666-6666-666666666666"
  ],
  "participantType": "Team"
}

participant.removed.group

When: A participant is removed from a group. Payload data: Same fields as participant.assigned.group. Example data:

{
  "tournamentId": "22222222-2222-2222-2222-222222222222",
  "groupId": "88888888-8888-8888-8888-888888888888",
  "groupName": "Group A",
  "roundId": "55555555-5555-5555-5555-555555555555",
  "roundName": "Round 1",
  "participantIds": [
    "66666666-6666-6666-6666-666666666666"
  ],
  "participantType": "Team"
}

participant.removed.match

When: A participant is removed from a match. Payload data: Same fields as participant.assigned.match. Example data:

{
  "tournamentId": "22222222-2222-2222-2222-222222222222",
  "roundId": "55555555-5555-5555-5555-555555555555",
  "matchId": "33333333-3333-3333-3333-333333333333",
  "participantIds": [
    "66666666-6666-6666-6666-666666666666"
  ],
  "participantType": "User"
}

Match Lifecycle

When: A match is created (e.g. in a round). Payload data:

Field	Type	Description
`tournamentId`	string	UUID of the tournament
`matchId`	string	UUID of the match
`roundId`	string	UUID of the round (if any)
`status`	string	Match status (e.g. match type or status)

Example data:

{
  "tournamentId": "t1t2t3t4-t5t6-7890-tour-nament1234567",
  "matchId": "m1m2m3m4-m5m6-7890-mat-ch1234567890",
  "roundId": "ro1ro2ro3-ro4-ro5-7890-round12345678",
  "status": "SingleElimination"
}

For match.created, status is currently the match type (e.g. SingleElimination, DoubleElimination, Ffa).

match.updated

When: A match is updated (e.g. score, status change). Payload data: Same structure as match.created; status is the match status (e.g. Scheduled, InProgress, Completed, Cancelled).

Field	Type	Description
`tournamentId`	string	UUID of the tournament
`matchId`	string	UUID of the match
`roundId`	string	UUID of the round (if any)
`status`	string	Match status

Tournaments

tournament.published

When: A tournament successfully published making it publicly available to users. Payload data:

Field	Type	Description
`tournamentId`	string	UUID of the tournament
`tournamentName`	string	Name of the tournament
`status`	string	Status of tournament publication

Example data:

{
  "tournamentId": "22222222-2222-2222-2222-222222222222",
  "tournamentName": "Spring Championship",
  "status": "Published"
}

tournament.rules.updated

When: Tournament rules are saved or changed. Payload data: Same shape as tournament.published — identifies the tournament and its current high-level status.

Field	Type	Description
`tournamentId`	string	UUID of the tournament
`tournamentName`	string	Name of the tournament
`status`	string	Tournament status (e.g. lifecycle)

Example data:

{
  "tournamentId": "94b24563-4816-451f-b7e7-1720e2a8e7c9",
  "tournamentName": "Auto Test Tournament",
  "status": "Upcoming"
}

tournament.points.updated

When: The tournament points configuration is saved or changed. Payload data: Same fields as tournament.rules.updated.

Field	Type	Description
`tournamentId`	string	UUID of the tournament
`tournamentName`	string	Name of the tournament
`status`	string	Tournament status (e.g. lifecycle)

Example data:

{
  "tournamentId": "94b24563-4816-451f-b7e7-1720e2a8e7c9",
  "tournamentName": "Auto Test Tournament",
  "status": "Upcoming"
}

Match announcements

id.pass.announcement

When: Match targeted announcement specifically meant to share room ID and password details or joining credentials. Payload data:

Field	Type	Description
`tournamentId`	string	UUID of the tournament
`matchId`	string	UUID of the match
`messageContent`	string	Room ID and credentials
`senderId`	string	UUID of the sender

Example data:

{
  "tournamentId": "22222222-2222-2222-2222-222222222222",
  "matchId": "33333333-3333-3333-3333-333333333333",
  "messageContent": "Room ID: 123456, PASS: abcd",
  "senderId": "44444444-4444-4444-4444-444444444444"
}

match.announcement

When: Announcement targets a specific match. Payload data: tournamentId, messageContent, senderId, matchId. Example data:

{
  "tournamentId": "t1t2t3t4-t5t6-7890-tour-nament1234567",
  "messageContent": "Match starts in 5 minutes.",
  "senderId": "s1s2s3s4-s5s6-7890-sen-der1234567890",
  "matchId": "m1m2m3m4-m5m6-7890-mat-ch1234567890"
}

group.announcement

When: Announcement targets a group. Payload data: tournamentId, messageContent, senderId, groupId.

round.announcement

When: Announcement targets a round. Payload data: tournamentId, messageContent, senderId, roundId.

tournament.announcement

When: Announcement is tournament-wide (no match/group/round target). Payload data: tournamentId, messageContent, senderId only.

Announcement events (common fields): All announcement events share tournamentId, messageContent, and senderId. The context field (matchId, groupId, or roundId) indicates the scope. If none are set, the announcement is tournament-wide.

Subscription

When creating or updating a webhook, set the events array to the event types you want (e.g. ["match.created", "match.updated"]). If events is null or empty, the webhook subscribes to all events above.

Custom payload format

If you use payload format custom and a Custom Payload Template, you can use placeholders such as:

{{eventType}}, {{eventId}}, {{timestamp}}, {{tenantId}}
{{tournamentId}}, {{externalId}}, {{participantId}}, {{participantType}}
Any key from the event’s Data (e.g. {{matchId}}, {{registrationId}}, {{messageContent}}).

The payload sent to your URL will then be the result of applying these placeholders to your template JSON.

​Delivery details

​Default payload envelope (all events)

​Event reference (all event types)

​Team

​team.member.joined

​team.member.removed

​Tournament joining

​tournament.player.joined

​tournament.team.joined

​Assignments & Placements

​participant.assigned.round

​participant.assigned.group

​participant.assigned.match

​participant.removed.round

​participant.removed.group

​participant.removed.match

​Match Lifecycle

​match.updated

​Tournaments

​tournament.published

​tournament.rules.updated

​tournament.points.updated

​Match announcements

​id.pass.announcement

​match.announcement

​Tournament-related announcements

​group.announcement

​round.announcement

​tournament.announcement

​Subscription

​Custom payload format

Delivery details

Default payload envelope (all events)

Event reference (all event types)

Team

team.member.joined

team.member.removed

Tournament joining

tournament.player.joined

tournament.team.joined

Assignments & Placements

participant.assigned.round

participant.assigned.group

participant.assigned.match

participant.removed.round

participant.removed.group

participant.removed.match

Match Lifecycle

match.updated

Tournaments

tournament.published

tournament.rules.updated

tournament.points.updated

Match announcements

id.pass.announcement

match.announcement

Tournament-related announcements

group.announcement

round.announcement

tournament.announcement

Subscription

Custom payload format