---
title: "Create a tenant-bound support ticket handoff"
method: POST
path: "/tenant/support-ticket"
---

# Create a tenant-bound support ticket handoff

`POST /tenant/support-ticket`

## Request

- Base URL: `https://api.gravityads.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gravityads.dev/tenant/support-ticket`
- Auth: HTTP bearer

## Request body

- object
  - `tenant_id` string
  - `request_id` string
  - `subject` string, required
  - `description` string
  - `severity` 'low' | 'normal' | 'high' | 'critical'
  - `category` 'billing' | 'data' | 'incident' | 'platform' | 'security' | 'support'
  - `created_by` string
  - `source` string
  - `send` boolean
  - `incident_trace` object

## Response `200`

Redacted tenant support ticket handoff

- object
  - `schema_version` 'gravityads.hosted_support_ticket.v1', required
  - `status` string, required
  - `ticket_id` string, required
  - `created_at_utc` string
  - `tenant_id_hash` string, required
  - `request_id_hash` string, required
  - `subject_hash` string, required
  - `subject_length` integer, required
  - `description_hash` string, required
  - `description_length` integer, required
  - `severity` string
  - `category` string
  - `support_provider` string
  - `provider_target_hash` string
  - `support_ticket_correlation_header` string
  - `ready_for_support_ticket_handoff` boolean
  - `send_requested` boolean
  - `send_blocker` string
  - `provider_called` boolean
  - `sent` boolean
  - `provider_status_code` integer
  - `external_ticket_id_hash` string
  - `provider_response_hash` string
  - `control_plane_record` object
  - `raw_ticket_payload_returned` false, required
  - `raw_provider_target_returned` false, required
  - `raw_secret_returned` false, required

---

[API](https://skmtc.dev/gravityads/apis/gravityads-api.md) · [All operations](https://skmtc.dev/gravityads/apis/gravityads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gravityads/apis/gravityads-api/revisions/124cd07d534d?raw)