---
title: "Open a support ticket."
method: POST
path: "/v1/support/tickets"
tags: ["support"]
---

# Open a support ticket.

`POST /v1/support/tickets`

## Request

- Base URL: `https://api.50heads.com`
- URL: `https://api.50heads.com/v1/support/tickets`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://auth.50heads.com/authorize`, token URL `https://auth.50heads.com/token`; client credentials, token URL `https://auth.50heads.com/token`)

Signed in (key, OAuth or session), the reply goes to the account's email. Without a token, send `email`. 10 tickets an hour.

## Request body

- SupportTicketInput
  - `subject` string, required
  - `body` string, required
  - `appVersion` string
  - `category` 'payout' | 'payout_failed' | 'account' | 'account_frozen' | 'verification' | 'question' | 'billing' | 'api' | 'security' | 'privacy' | 'press' | 'legal' | 'support' | 'other'
  - `email` string, email
  - `locale` string
  - `website` string
  - `openedAt` integer

## Response `201`

OK

- SupportTicketResponse
  - `ticketId` string, required

## Other responses

- `400`: The request is not valid; `error.details.validation` lists the fixes.
- `401`: No key or token, or it expired or was revoked.
- `403`: The key or token lacks the scope (`insufficient_scope`), or the action is not allowed.
- `429`: Too many requests; wait for Retry-After.

---

[API](https://skmtc.dev/50heads/apis/50heads-api.md) · [All operations](https://skmtc.dev/50heads/apis/50heads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/50heads/apis/50heads-api/revisions/20175e8b00e3?raw)