Skip to main content
POST
Add or re-approve an official (idempotent upsert)

Authorizations

Authorization
string
header
required

Partner API key: Authorization: Bearer whk_…. Keys are issued by the Whistle team (email tommy@huddleup-sports.com), shown once at issuance, and bound to your source namespace — they access only your leagues (plus explicit grants) and your webhook endpoints. Any auth failure returns 401 {"error":"unauthorized"}; the API never returns 403 — out-of-scope resources answer 404 exactly like nonexistent ones.

Path Parameters

leagueId
string
required

Whistle league id (id from league responses).

Body

application/json
externalId
string
required

Your stable id for this official. Required.

source
string

Derived from your key — omit, or echo your key's source; any other value returns 400 source_mismatch.

email
string

Optional bridge to the official's real identity. Trimmed and lowercased.

name
string
status
enum<string>

Only "pending" is honored; everything else becomes "approved".

Available options:
approved,
pending

Response

Official membership

data
object
Last modified on July 13, 2026