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",
"custom_attributes": {
"lead_source": "Webinar"
}
},
{
"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": [],
"ignored_custom_attributes": []
}
}{
"error": {
"type": "validation_error",
"code": "DIALING_QUEUE_LIMIT_REACHED",
"message": "The dialing queue cannot exceed 25,000 numbers.",
"retryable": false
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"retryable": true,
"request_id": "<string>",
"retry_after_seconds": 123
}
}{
"error": {
"type": "not_found_error",
"code": "ASSIGNEE_NOT_FOUND",
"message": "No team member found for the provided 'user_id' or 'email'.",
"retryable": false,
"suggestion": "List your teammates with GET /v2/api/users and use one of their ids as 'user_id', or pass a team-member email."
}
}{
"error": {
"type": "conflict_error",
"code": "DIALING_QUEUE_APPEND_CONFLICT",
"message": "A concurrent append to this queue caused a position conflict.",
"retryable": false,
"suggestion": "Retry the request — the conflict resolves on the next attempt."
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"retryable": true,
"request_id": "<string>",
"retry_after_seconds": 123
}
}Power Dialer
Ajouter des numeros
Appends phone numbers to the Power Dialer queue assigned to the authenticated user. Creates the queue implicitly if none exists. Send user_id or email to append to a teammate’s queue — if that teammate has no current queue, one is created with the API key owner as creator_id and the teammate as assignee_id. user_id wins when both are provided.
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",
"custom_attributes": {
"lead_source": "Webinar"
}
},
{
"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": [],
"ignored_custom_attributes": []
}
}{
"error": {
"type": "validation_error",
"code": "DIALING_QUEUE_LIMIT_REACHED",
"message": "The dialing queue cannot exceed 25,000 numbers.",
"retryable": false
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"retryable": true,
"request_id": "<string>",
"retry_after_seconds": 123
}
}{
"error": {
"type": "not_found_error",
"code": "ASSIGNEE_NOT_FOUND",
"message": "No team member found for the provided 'user_id' or 'email'.",
"retryable": false,
"suggestion": "List your teammates with GET /v2/api/users and use one of their ids as 'user_id', or pass a team-member email."
}
}{
"error": {
"type": "conflict_error",
"code": "DIALING_QUEUE_APPEND_CONFLICT",
"message": "A concurrent append to this queue caused a position conflict.",
"retryable": false,
"suggestion": "Retry the request — the conflict resolves on the next attempt."
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"retryable": true,
"request_id": "<string>",
"retry_after_seconds": 123
}
}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, envoyezuser_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 viaGET /v2/api/users.email— utilise uniquement quanduser_idest absent.
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.
Champs personnalisés
Chaque numéro peut portercustom_attributes : des valeurs pour les champs personnalisés des personnes de votre équipe, indexées par la key du champ. Listez les clés avec GET /v2/api/crm/attributes. Les valeurs sont écrites sur le contact du numéro, et le contact est créé si le numéro n’en a pas.
{
"numbers": [
{
"number": "+12125550010",
"name": "John",
"custom_attributes": {
"lead_source": "Webinar",
"deal_size": "1200",
"next_meeting": "2026-11-03"
}
}
]
}
| Type de champ | Valeur |
|---|---|
TEXT | N’importe quel texte |
NUMBER | Un nombre, comme 1200 ou 12.5 |
DATE | YYYY-MM-DD ou une date-heure ISO, ou un jour, un mois et une année à 4 chiffres séparés par /, - ou ., comme 03/04/2026 |
BOOLEAN | true/false, 1/0, yes/no, y/n ou oui/non, majuscules ou minuscules |
DROPDOWN | Le label ou la clé d’une des options du champ |
Ordre des dates
03/04/2026 est le 3 avril en Europe et le 4 mars aux États-Unis. Envoyez date_order à côté de numbers pour préciser lequel : DAY_FIRST ou MONTH_FIRST. Il s’applique à tous les champs date de la requête.
{
"date_order": "MONTH_FIRST",
"numbers": [
{ "number": "+12125550010", "custom_attributes": { "next_meeting": "11/03/2026" } }
]
}
date_order, chaque champ date est lu dans l’ordre que ses propres valeurs imposent : 13/04/2026 ne peut être que jour en premier, 04/13/2026 que mois en premier. Quand les valeurs ne tranchent pas, le pays de votre numéro décide : mois en premier pour les États-Unis, jour en premier partout ailleurs.
Les valeurs vides sont ignorées. Quand le contact existe déjà, seuls ses champs vides sont remplis : une valeur déjà renseignée est conservée.
Cet endpoint ne crée jamais de champ personnalisé. Créez-les d’abord avec POST /v2/api/crm/attributes.
Une clé qui ne correspond à aucun champ personnalisé de votre équipe, ou qui désigne un champ supprimé, est ignorée. Le numéro est tout de même ajouté avec ses attributs connus, et les clés inconnues sont listées dans ignored_custom_attributes : un tableau toujours présent d’entrées { "number", "keys" }, avec number au format E.164. Le tableau est vide quand aucune clé n’a été ignorée.
{
"added": [{ "number_to": "+12125550010", "position": 0 }],
"skipped": [],
"ignored_custom_attributes": [
{ "number": "+12125550010", "keys": ["unknown_field"] }
]
}
skipped :
reason | Signification |
|---|---|
INVALID_CUSTOM_ATTRIBUTE_VALUE | Une valeur ne correspond pas au type de son champ : bientôt ou 31/02/2026 pour un champ DATE, une année à 2 chiffres comme 03/04/26, peut-être pour un champ BOOLEAN |
Autorisations
Corps
application/json
Numbers to append to the queue. Each entry requires a phone number; contact metadata is optional.
Minimum array length:
1Show child attributes
Show child attributes
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"
Optional. Email of a teammate whose queue should receive the numbers. Ignored when user_id is also supplied.
Exemple:
Optional. How to read numeric DATE values in custom_attributes such as 03/04/2026: DAY_FIRST (3 April) or MONTH_FIRST (4 March). Applies to every date field in the request. When absent, each date field is read in the order its values settle (a 13/04/2026 can only be day first); when none settle it, your phone number's country decides: month first for the US, day first everywhere else.
Options disponibles:
DAY_FIRST, MONTH_FIRST Exemple:
"DAY_FIRST"
Réponse
Numbers appended
Show child attributes
Show child attributes
Cette page vous a-t-elle été utile ?