> ## 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. # 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. ## 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`](/fr/v2/api-reference/users/list-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`. ## OpenAPI ````yaml POST /v2/api/dialing-queues/current/numbers openapi: 3.0.3 info: title: Allo API description: >- Allo API provides programmatic access to your Allo account, allowing you to manage webhooks, retrieve calls and contacts, and send SMS messages. All requests to `/v1/api/**` endpoints automatically go through quota checking and scope validation. version: 1.0.0 contact: name: Allo Support servers: - url: https://api.withallo.com description: Production server security: [] tags: - name: Summary Templates description: >- Manage call summary templates that control how AI-generated call summaries are structured for your team. - name: Webhooks description: >- Manage webhook configurations to receive real-time notifications about events in your Allo account. Each webhook is associated with a specific Allo phone number. - name: Calls description: >- Retrieve and search call records with filtering and pagination. Filter calls by your Allo phone number. - name: Contacts description: >- Search and retrieve contact information with sorting and pagination. Includes engagement level tracking. - name: SMS description: Send SMS messages to phone numbers using your Allo numbers. - name: Phone Numbers description: Retrieve information about your Allo phone numbers. - name: Analytics description: Pre-computed call metrics, team performance, and outbound dial funnel - name: CRM description: Manage people, companies, and deals in your CRM. paths: /v2/api/dialing-queues/current/numbers: post: tags: - Power Dialer summary: Append numbers to queue description: >- 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. operationId: appendDialingQueueNumbers requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AppendQueueNumbersRequest' examples: self: summary: Append to your own queue value: numbers: - number: +1 (212) 555-0010 name: John last_name: Doe company: Acme Inc job_title: Sales Manager emails: - john.doe@acme.com website: https://acme.com - number: +33 6 12 34 56 78 name: Marie last_name: Dupont company: Acme Inc - number: +44 20 7946 0958 teammate_by_pid: summary: Append to a teammate's queue by user_id value: user_id: usr-15BB68317A7F06F0C07A3BBD8F244102A6872220 numbers: - number: '+12125550010' name: John last_name: Doe teammate_by_email: summary: Append to a teammate's queue by email value: email: teammate@acme.com numbers: - number: '+12125550010' name: John last_name: Doe responses: '200': description: Numbers appended content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/AppendQueueNumbersResponse' example: 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: [] '400': description: Queue limit reached or validation error content: application/json: schema: $ref: 7e1afcc0-b8dd-4a14-8d64-64c2d4e10b12 example: error: type: validation_error code: DIALING_QUEUE_LIMIT_REACHED message: The dialing queue cannot exceed 1,000 numbers. retryable: false '401': $ref: '#/components/responses/ApiUnauthorized' '404': description: Assignee not found content: application/json: schema: $ref: 7e1afcc0-b8dd-4a14-8d64-64c2d4e10b12 example: 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. '409': description: Concurrent append conflict content: application/json: schema: $ref: 7e1afcc0-b8dd-4a14-8d64-64c2d4e10b12 example: 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. '429': $ref: '#/components/responses/ApiRateLimited' security: - ApiKeyAuth: [] components: schemas: AppendQueueNumbersRequest: type: object required: - numbers properties: numbers: type: array description: >- Numbers to append to the queue. Each entry requires a phone number; contact metadata is optional. minItems: 1 items: type: object required: - number properties: number: type: string description: Phone number in any format — will be normalized to E.164 name: type: string nullable: true description: First name (optional — used to create or match a contact) last_name: type: string nullable: true description: Last name company: type: string nullable: true description: >- Company name — matched by name within the team (case-insensitive). If no matching company exists, one is created automatically. website: type: string nullable: true description: Website URL job_title: type: string nullable: true description: Job title emails: type: array nullable: true items: type: string description: Email addresses addresses: type: array nullable: true items: type: string description: Physical addresses user_id: type: string nullable: true description: >- 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](/en/v2/api-reference/users/list-users). example: usr-15BB68317A7F06F0C07A3BBD8F244102A6872220 email: type: string format: email nullable: true description: >- Optional. Email of a teammate whose queue should receive the numbers. Ignored when `user_id` is also supplied. example: teammate@acme.com AppendQueueNumbersResponse: type: object properties: added: type: array description: Numbers that were successfully appended items: $ref: '#/components/schemas/QueueNumber' skipped: type: array description: Numbers that were skipped (e.g. invalid format) items: type: object properties: number: type: string description: The raw input number that was skipped reason: type: string enum: - INVALID_PHONE_NUMBER description: Why the number was skipped QueueNumber: type: object description: A phone number entry in a Power Dialer queue properties: number_to: type: string description: E.164 destination phone number position: type: integer description: Order within the queue (0-based) created_at: type: string format: date-time updated_at: type: string format: date-time call_start_date: type: string format: date-time nullable: true description: >- When the user started calling this entry. `null` if the entry is still unassigned. call_id: type: string nullable: true description: >- ID of the call placed for this entry (`cll-*`). `null` until a call is placed. routing_result: type: string nullable: true enum: - FAILED - RECEIVED - BLOCKED - ANSWERED - TRANSFERRED_BLAND - TRANSFERRED_ELEVEN_LABS - TRANSFERRED_EXTERNAL - FAILED_EXTERNAL - VOICEMAIL - CLOSED description: Final routing outcome of the call placed for this entry. sync_status: type: string enum: - NOT_SYNCED - PROCESSING - SYNCED description: State of contact creation/sync for this entry. detected_outbound_voicemail: type: boolean nullable: true description: Whether the call was detected as having reached a voicemail box. not_reached_destination_reason: type: string nullable: true enum: - BUSY - CALLEE_TEMPORARILY_UNAVAILABLE - RING_TIMEOUT - NOT_IN_SERVICE - DECLINED - NETWORK_ERROR description: Why the call did not reach the contact (only set when applicable). voicemail_left: type: boolean nullable: true description: Whether the user left a voicemail on this entry. ApiError: type: object properties: error: type: object properties: type: type: string code: type: string message: type: string retryable: type: boolean request_id: type: string retry_after_seconds: type: integer nullable: true responses: ApiUnauthorized: description: Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/ApiError' ApiRateLimited: description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ApiError' securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization ````