Rivier/ Reference/ inbox

Create a queue

post/contact-centre/queues

Create a queue: skills needed, channels, first-response and resolution targets, and an optional AI agent that answers first.

Before you call

Credential
Authorization: Bearer $KEY
Scope
inbox:write
Graphql
Mutation.inboxContactCentreQueueCreate
Sdk
desk.queues.create
Cli
desk queue-add

Request bodyapplication/json, required

  • namestringrequired
    At most 80 characters.
  • skillslist of string
    Skills an agent needs to be given a conversation from this queue
  • channelslist of string
  • firstResponseSecondsinteger
    At least 60. At most 604800.
  • resolveSecondsinteger
    At least 300. At most 2592000.
  • aiAgentIdstring (uuid) or null
    An AI agent that answers first

Responses

  • 201application/json
    Success
    • 400application/json
      The request was malformed
      • errorstringrequired
      • messagestring
    • 401application/json
      No valid credential
      • errorstringrequired
      • messagestring
    • 403application/json
      The credential lacks the scope, origin or address
      • errorstringrequired
      • messagestring
    • 429application/json
      Over the key's rate limit; see Retry-After
      • errorstringrequired
      • messagestring

    This page as Markdown