bird support-tickets create [flags]
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.
# print the body shape (no credentials needed)
bird support-tickets create --example
# the body it prints:
{
"area": "email",
"message": "Hi, I need help setting up my sending domain.",
"priority": "MEDIUM",
"title": "Domain verification stuck",
"type": "support"
}
# 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
| 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 |
| 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 |
| 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) |
| 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 |
| Name | Description |
|---|
--response-schema | Print the fields this command returns, then exit |