Passer au contenu principal
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": []
  }
}

Documentation Index

Fetch the complete documentation index at: https://help.withallo.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Cibler la file d’un coequipier

Par defaut, les numeros sont ajoutes a la file assignee au proprietaire de la cle API. Pour ajouter a la file d’un coequipier, envoyez user_pid ou email dans le corps JSON. Le coequipier doit appartenir a la meme equipe que le proprietaire de la cle API.
  • user_pid — l’emporte quand les deux sont fournis. Resolvez les pids des coequipiers via GET /v2/api/users.
  • email — utilise uniquement quand user_pid est absent.
Si le coequipier n’a pas de file en cours, une nouvelle file est creee avec le proprietaire de la cle API comme creator_id et le coequipier comme assignee_id. Si l’utilisateur resolu n’est pas dans votre equipe, la reponse est 404 ASSIGNEE_NOT_FOUND.

Autorisations

​
Authorization
string
header
requis

Corps

application/json
​
numbers
object[]
requis

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

Minimum array length: 1
​
user_pid
string | null

Optional. Pid 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 pids via GET /v2/api/users.

Exemple:

"usr-15BB68317A7F06F0C07A3BBD8F244102A6872220"

​
email
string<email> | null

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

Exemple:

"[email protected]"

Réponse

Numbers appended

​
data
object