# `bird support-tickets create`

## Usage

```bash
bird support-tickets create [flags]
```

## Description

Open a support ticket with Bird.

Opens a new ticket with the first message and returns it. Use --type support for
a human request or the default --type ai for an automated answer; follow up with
"bird support-tickets reply". The reply (automated or from a person, either can answer
your question) arrives asynchronously, so don't drop the ticket: pass --watch to block
until a reply lands, running it as a background task where your environment supports
that, or wait later with "bird support-tickets get <id> --watch".

Build the request from flags, a JSON CreateSupportTicket body via --body-file ("-" reads
stdin), or both — a flag overrides the matching body field. Run --example to
print a ready-to-edit body, or --dry-run to print the resolved request without
sending it.

## Examples

```bash
# print the body shape (no credentials needed)
bird support-tickets create --example

# the body it prints:
```

```json
{
  "area": "email",
  "message": "Hi, I need help setting up my sending domain.",
  "priority": "MEDIUM",
  "title": "Domain verification stuck",
  "type": "support"
}
```

```bash
# open a human support request
bird support-tickets create --type support --message "DKIM verification is stuck"

# preview the request without sending
bird support-tickets create --message "hi" --dry-run
```

## Options

#### Ticket

| Name         | Description                                                   |
| ------------ | ------------------------------------------------------------- |
| `--message`  | First message in the ticket                                   |
| `--title`    | Subject for the ticket; derived from the message when omitted |
| `--type`     | Routing: ai (default), support, or feedback                   |
| `--priority` | Urgency: LOW, MEDIUM (default), HIGH, or CRITICAL             |

#### Routing

| Name              | Description                                                                                      |
| ----------------- | ------------------------------------------------------------------------------------------------ |
| `--area`          | Support team when type is "support": email, sms, whatsapp, voice, api, dashboard, billing, other |
| `--feedback-kind` | Feedback category when type is "feedback": feature-request, improvement, bug, general            |

#### Watch

| Name              | Description                                                            |
| ----------------- | ---------------------------------------------------------------------- |
| `--watch`         | Wait for a support agent to reply, then print the result and exit      |
| `--watch-timeout` | How long --watch waits before giving up (capped at 30m) (default 5m0s) |

#### Request

| Name                | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| `--body-file`       | Read the JSON request body from this file; "-" reads stdin   |
| `--example`         | Print a complete example request body, then exit             |
| `--dry-run`         | Print the resolved request without sending it, then exit     |
| `--idempotency-key` | Deduplication key; a retry with the same key won't act twice |

#### Options

| Name                | Description                                      |
| ------------------- | ------------------------------------------------ |
| `--response-schema` | Print the fields this command returns, then exit |

## Related

| Name                                                                        | Description                                                |
| --------------------------------------------------------------------------- | ---------------------------------------------------------- |
| [`bird support-tickets get`](/docs/cli/reference/support-tickets-get)       | Get a support ticket                                       |
| [`bird support-tickets list`](/docs/cli/reference/support-tickets-list)     | List support tickets                                       |
| [`bird support-tickets reply`](/docs/cli/reference/support-tickets-reply)   | Reply to an existing support ticket.                       |
| [`bird support-tickets viewed`](/docs/cli/reference/support-tickets-viewed) | Record that the authenticated user viewed a support ticket |