Tickets

Create ticket inbox

Creates a ticket inbox for the project tied to your API key and returns the created inbox object including its server-assigned id. Provide a display name and a config object that defines ticketing behavior for the channel/queue. The config.ticket_types you set here become the allowed categories used by ticket create and update_type operations.

POST

https://api.nabrah.ai/api/ext/omni_v2/ticket/inboxes

Create ticket inbox

curl --request POST \
  --url 'https://api.nabrah.ai/api/ext/omni_v2/ticket/inboxes' \
  --header 'X-API-Key: <your-api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "WhatsApp Support",
  "config": {
    "auto_assign": true,
    "ticket_types": [
      "support",
      "billing",
      "sales"
    ],
    "alway_create_ticket": false,
    "assign_list": [
      "user_7c19a2",
      "user_3ab8f1"
    ],
    "lock_to_single_open_ticket": true
  }
}'

{
  "id": 0,
  "inbox_type": "whatsapp",
  "inbox_id": 0,
  "project_id": "00000000-0000-4000-8000-000000000000",
  "name": "string",
  "config": {},
  "created_at": "2026-01-15T12:00:00.000Z"
}

Request fields

name

Human-readable display name for the inbox.

name

config

auto_assign toggles automatic assignment of new tickets. ticket_types is the list of allowed ticket categories. alway_create_ticket (note the spelling) forces a ticket for every inbound conversation. assign_list is the pool of user ids eligible for auto-assignment. lock_to_single_open_ticket limits a contact to one open ticket at a time.

auto_assignticket_typesalway_create_ticketassign_listlock_to_single_open_ticket

Returns a GetInboxResponse — the created inbox object (id, inbox_type, inbox_id, project_id, name, config, created_at).

Authorization

X-API-Keystringheaderrequired

Your workspace API key. Create one in the dashboard under API keys.

Body

application/json

Create a ticket inbox with ticketing config.

Example

{
  "name": "WhatsApp Support",
  "config": {
    "auto_assign": true,
    "ticket_types": [
      "support",
      "billing",
      "sales"
    ],
    "alway_create_ticket": false,
    "assign_list": [
      "user_7c19a2",
      "user_3ab8f1"
    ],
    "lock_to_single_open_ticket": true
  }
}

Response

200

Successful Response

application/json

422

Validation Error

application/json