Skip to main content
POST
/
v2
/
api
/
dialing-queues
/
current
/
numbers
curl --request POST \
  --url https://api.withallo.com/v2/api/dialing-queues/current/numbers \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "numbers": [
    {
      "number": "+1 (212) 555-0010",
      "name": "John",
      "last_name": "Doe",
      "company": "Acme Inc",
      "job_title": "Sales Manager",
      "emails": [
        "[email protected]"
      ],
      "website": "https://acme.com"
    },
    {
      "number": "+33 6 12 34 56 78",
      "name": "Marie",
      "last_name": "Dupont",
      "company": "Acme Inc"
    },
    {
      "number": "+44 20 7946 0958"
    }
  ]
}
'
{
  "data": {
    "added": [
      {
        "number_to": "+12125550010",
        "position": 0,
        "created_at": "2026-04-30T10:00:00",
        "updated_at": "2026-04-30T10:00:00"
      },
      {
        "number_to": "+33612345678",
        "position": 1,
        "created_at": "2026-04-30T10:00:00",
        "updated_at": "2026-04-30T10:00:00"
      }
    ],
    "skipped": []
  }
}

​
Targeting a teammate’s queue

By default, numbers are appended to the queue assigned to the API key owner. To append to a teammate’s queue, send user_id or email in the JSON body. The teammate must belong to the same team as the API key owner.
  • user_id — wins when both are provided. Resolve teammate ids via GET /v2/api/users.
  • email — used only when user_id is absent.
If the teammate has no current queue, one is created with the API key owner recorded as creator_id and the teammate as assignee_id. If the resolved user isn’t on your team, the response is 404 ASSIGNEE_NOT_FOUND.

Authorizations

​
Authorization
string
header
required

Body

application/json
​
numbers
object[]
required

Numbers to append to the queue. Each entry requires a phone number; contact metadata is optional.

Minimum array length: 1
​
user_id
string | null

Optional. ID of a teammate whose queue should receive the numbers. The teammate must belong to the same team as the API key owner. Wins over email when both are provided. Resolve teammate ids via GET /v2/api/users.

Example:

"usr-15BB68317A7F06F0C07A3BBD8F244102A6872220"

​
email
string<email> | null

Optional. Email of a teammate whose queue should receive the numbers. Ignored when user_id is also supplied.

Example:

"[email protected]"

Response

Numbers appended

​
data
object