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": []
  }
}

​
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_id ou email dans le corps JSON. Le coequipier doit appartenir a la meme equipe que le proprietaire de la cle API.
  • user_id — l’emporte quand les deux sont fournis. Resolvez les ids des coequipiers via GET /v2/api/users.
  • email — utilise uniquement quand user_id 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_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.

Exemple:

"usr-15BB68317A7F06F0C07A3BBD8F244102A6872220"

​
email
string<email> | null

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

Exemple:

"[email protected]"

Réponse

Numbers appended

​
data
object