---
title: "Open a support ticket"
method: POST
path: "/api/v1/tickets"
---

# Open a support ticket

`POST /api/v1/tickets`

## Request

- Base URL: `https://ipmusk.com`
- URL: `https://ipmusk.com/api/v1/tickets`
- Auth: HTTP bearer

Opens a ticket, optionally linked to an order and one of its resources. The Idempotency-Key header makes a retry return the same ticket instead of opening a second one. Rate limited per account.

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `type` 'technical' | 'billing' | 'other', required
  - `subject` string, required
  - `message` string, required
  - `order_id` string
  - `credential_id` string
  - `static_proxy_id` string

## Response `201`

Open a support ticket

- object
  - `data` object, required
    - `id` string, required
    - `type` 'technical' | 'billing' | 'other', required
    - `subject` string, required
    - `status` 'open' | 'waiting_for_customer' | 'waiting_for_support' | 'resolved' | 'closed', required
    - `order_id` string, nullable, required
    - `credential_id` string, nullable, required
    - `static_proxy_id` string, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `messages` object[], required
      - `id` string, required
      - `author` 'customer' | 'support', required
      - `body` string, required
      - `created_at` string, date-time, required
  - `request_id` string, required

## Other responses

- `default`: Any failure: 400 validation_error, 401 authentication_required, 403 forbidden / capability_unavailable, 404 not_found, 409 invalid_state_transition / idempotency_conflict, 422 product_unavailable, 429 rate_limited, 500 internal_error.

---

[API](https://skmtc.dev/ipmusk/apis/ipmusk-customer-api.md) · [All operations](https://skmtc.dev/ipmusk/apis/ipmusk-customer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ipmusk/apis/ipmusk-customer-api/revisions/89f8b46fda61?raw)