Create

POST

/api/v1/automation-queues

Creates an automation queue — the mechanism that routes incoming conversations to agents.

agentIds and managerIds each need at least one user; use User → Listing to find IDs. The same person may be both.

Set maximumAssignPerAgent deliberately: omitted, it defaults to 1, so each agent holds a single conversation at a time.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢201

application/json

Bodyapplication/json

🟠401Unauthorized

🟠429Too Many Requests

🟠409Conflict

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://apigw.klinkcx.com/api/v1/automation-queues' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "string",
    "agentIds": [
        "string"
    ],
    "managerIds": [
        "string"
    ],
    "description": "string",
    "emoji": "string",
    "distributionStrategy": "round-robin",
    "maximumAssignPerAgent": 0,
    "useGlobalAgentCapacity": true,
    "offlineAssignment": true,
    "autoAssign": true
}'

Response Example

201 - Example 1

{
    "requestId": "string",
    "data": {
        "id": "string",
        "name": "string",
        "description": "string",
        "emoji": "string",
        "distributionStrategy": "round-robin",
        "maximumAssignPerAgent": 0,
        "useGlobalAgentCapacity": true,
        "offlineAssignment": true,
        "autoAssign": true,
        "members": [
            {
                "userId": "string",
                "name": "string",
                "email": "string",
                "membershipRole": "agent"
            }
        ],
        "createdAt": "string",
        "updatedAt": "string"
    }
}

Modified at 2026-08-10 03:17:50

Delete

Listing