---
title: "Add a tournament participant"
method: POST
path: "/v1/tournaments/{tournament_id}/participants"
tags: ["Tournament Participants"]
---

# Add a tournament participant

`POST /v1/tournaments/{tournament_id}/participants`

## Request

- Base URL: `https://api.hify.club`
- URL: `https://api.hify.club/v1/tournaments/{tournament_id}/participants`
- Auth: API key in header `X-User-Token`

Register a player as a participant. Admin only.

## Request body

- object
  - `participant` object, required
    - `participant_type` 'User' | 'AnonymousTournamentParticipant', required
    - `participant_id` string, uuid, required
    - `seed` integer: Seeding rank for bracket placement

## Response `201`

Participant added

- TournamentParticipant
  - `id` integer
  - `tournament_id` string, uuid
  - `participant_type` 'User' | 'AnonymousTournamentParticipant'
  - `participant_id` string, uuid
  - `seed` integer, nullable
  - `name` string, nullable: The name the participant renders under.
  - `external_id` string, nullable: The partner's own player id, for an AnonymousTournamentParticipant a feed created. Null for a User.
  - `linked_user_id` string, uuid, nullable: The account an anonymous participant was linked to when the feed's phone number found one. Null for a User.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden — admin access required
- `404`: Tournament not found
- `422`: Unprocessable entity

---

[API](https://skmtc.dev/hify/apis/hify-apis.md) - [All operations](https://skmtc.dev/hify/apis/hify-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/hify/apis/hify-apis/revisions/b5920403538d?raw)