> ## Documentation Index
> Fetch the complete documentation index at: https://docs.minimo.it/llms.txt
> Use this file to discover all available pages before exploring further.

# List WhatsApp Senders

> Discover the connected WhatsApp numbers you can send from (multi-sender / multi-WABA)

## Overview

A single Minimo company can connect **more than one WhatsApp number** — for example a
support line and a marketing line, possibly under different WhatsApp Business Accounts
(WABAs). This endpoint returns the numbers you are allowed to send from, so you know
which values you can pass as the `sender` field of a [WhatsApp send](/api-reference/messaging-channels/whatsapp/send-template).

The response is a **redacted** view: it deliberately excludes secrets and internal
fields (API keys, client IDs, webhook URLs). It only exposes what you need to pick a
sender.

<Tip>
  Connect and manage your WhatsApp numbers from the **Channels** section at
  [app.minimo.it/channels](https://app.minimo.it/channels).
</Tip>

## Response Structure

```json theme={null}
{
  "items": [
    {
      "phoneNumber": "+393511234567",
      "phoneName": "Acme Support",
      "phoneNumberId": "123456789012345",
      "isPreferred": true
    },
    {
      "phoneNumber": "+393517654321",
      "phoneName": "Acme Marketing",
      "phoneNumberId": "543210987654321",
      "isPreferred": false
    }
  ],
  "pagination": {
    "totalRecords": 2,
    "currentPage": 1,
    "totalPages": 1,
    "nextPage": null,
    "prevPage": null
  }
}
```

## Fields

| Field           | Type      | Description                                                                                               |
| --------------- | --------- | --------------------------------------------------------------------------------------------------------- |
| `phoneNumber`   | `string`  | The display phone number — the primary value to pass as `sender`.                                         |
| `phoneName`     | `string`  | The WhatsApp Business display name of the number.                                                         |
| `phoneNumberId` | `string`  | The Meta `phone_number_id` — also accepted as `sender`. May differ for 360dialog-connected numbers.       |
| `isPreferred`   | `boolean` | Whether this is the company **default** number, used when a send omits `sender`. Exactly one per company. |

## How the sender is resolved on a send

When you call
[`POST /public/v1/templates/whatsapp/send`](/api-reference/messaging-channels/whatsapp/send-template),
Minimo picks the number to send **from** as follows:

1. If you pass `sender`, that number is used. You may pass either the `phoneNumber`
   (in any formatting — E.164, spaces, etc.) or the `phoneNumberId`.
2. If you omit `sender`, the company **preferred** number (`isPreferred: true`) is used.

<Warning>
  Passing a `sender` that isn't one of the company's connected numbers returns `WHATSAPP_SENDER_NOT_FOUND`. Always
  source the value from this endpoint.
</Warning>

## Example: send from a specific number

```bash theme={null}
# 1. Discover the senders
curl https://api.minimo.it/public/v1/templates/whatsapp/senders \
  -H "Authorization: Bearer mn-abc123-xyz789"

# 2. Send FROM the marketing number
curl https://api.minimo.it/public/v1/templates/whatsapp/send \
  -H "Authorization: Bearer mn-abc123-xyz789" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "recipient": "393471234567",
    "type": "template",
    "sender": "+393517654321",
    "template": {
      "name": "product_launch",
      "components": [
        { "type": "BODY", "parameters": [ { "type": "text", "text": "Jane" } ] }
      ]
    }
  }'
```

## Related Endpoints

* [Send WhatsApp Template](/api-reference/messaging-channels/whatsapp/send-template) - Send messages, optionally from a chosen `sender`
* [List WhatsApp Templates](/api-reference/messaging-channels/whatsapp/list-templates) - View all available templates


## OpenAPI

````yaml get /public/v1/templates/whatsapp/senders
openapi: 3.1.0
info:
  title: API Documentation
  description: Documentation for transactional and subscribe APIs
  version: 1.0.0
servers:
  - url: https://app.minimo.it
security:
  - bearerAuth: []
paths:
  /public/v1/templates/whatsapp/senders:
    servers:
      - url: https://api.minimo.it
    get:
      summary: List connected WhatsApp numbers (senders)
      description: >-
        Returns the company WhatsApp numbers that can be used as the `sender` of
        a WhatsApp send. Secrets are never included. The number flagged
        `isPreferred` is the one used when a send omits `sender`.
      operationId: listWhatsappSenders
      responses:
        '200':
          description: Successful response with connected WhatsApp senders
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/WhatsappSender'
                  pagination:
                    type: object
                    properties:
                      totalRecords:
                        type: integer
                        example: 2
                      currentPage:
                        type: integer
                        example: 1
                      totalPages:
                        type: integer
                        example: 1
                      nextPage:
                        type: integer
                        nullable: true
                        example: null
                      prevPage:
                        type: integer
                        nullable: true
                        example: null
        '400':
          description: Invalid or missing authentication token
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Missing API client ID or API key
      security:
        - bearerAuth: []
components:
  schemas:
    WhatsappSender:
      type: object
      description: >-
        A connected WhatsApp number (sender) usable as the `sender` of a send.
        This is a redacted, public view — secrets and internal fields are never
        included.
      properties:
        phoneNumber:
          type: string
          description: The display phone number — the primary value to pass as `sender`.
          example: '+393511234567'
        phoneName:
          type: string
          description: The WhatsApp Business display name of the number.
          example: Acme Support
        phoneNumberId:
          type: string
          description: >-
            The Meta `phone_number_id` — also accepted as `sender`. May differ
            for 360dialog-connected numbers.
          example: '123456789012345'
        isPreferred:
          type: boolean
          description: >-
            Whether this is the company default number (used when `sender` is
            omitted). Exactly one number is preferred per company.
          example: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: mn-API_CLIENT_ID-API_KEY

````