Workspace configuration
Create a queue
Creates a queue, a group of people who take calls and tickets together. Set strategy (how calls are offered), ring_seconds, wrap_seconds and members.
Requires: desk.admin scope, workspace owner or admin.
Authorization
bearerAuth AuthorizationBearer <token>
A SautiDesk API key. An owner or admin makes it under Settings in SautiDesk for a named person and picks the scopes. The key is shown once. Send it as Authorization: Bearer <key>. It acts as that person and as nobody else.
In: header
Request Body
application/json
Response
Created
Example
{ "id": "3f2b8c1e-5a4d-4e7b-9c10-2d6a8e4f1b37", "name": "Amina Wanjiru", "acd_name": "example", "strategy": "example", "ring_seconds": 60, "wrap_seconds": 60, "position": 1, "members": [ { "user_id": "ba7d8e12-8a4f-478d-9d10-86689fa3b682", "name": "Amina Wanjiru", "ring_to": "example", "provisioned_at": "2026-10-14T08:30:00Z", "pending_reason": "Waiting for the customer", "rings": false, "not_ringing_reason": "Away" } ]}FieldTypeDescription
idrequiredstring (uuid)namerequiredstringA name for it.acd_namerequiredstringstrategyrequiredstringHow calls are offered to the people in the queue, for example longest_free (the person free the longest), which is the default.ring_secondsrequiredintegerHow long a call rings one person before it moves on.wrap_secondsrequiredintegerHow long a person is left free of new calls after one ends, to write up.positionrequiredintegerWhere it sits in the list, starting at 0.membersrequiredobject[]The ids of the people in the queue.user_idrequiredstring (uuid)The id of the person.namerequiredstringA name for it.ring_torequiredstringThe phone number this person's calls ring.provisioned_atstring (date-time) | nullpending_reasonstringringsrequiredbooleannot_ringing_reasonstringcurl -X POST "https://api.sautidesk.com/v1/desk/queues" \ -H "Content-Type: application/json" \ -d '{ "name": "Amina Wanjiru", "strategy": "example", "ring_seconds": 60, "wrap_seconds": 60, "members": [ "61dc48c1-bf3c-44bf-9ee7-1d4d4f2f5793" ] }'