> ## 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.

# Custom numbers, multiple numbers & agencies

> Minimo is a WhatsApp Business Solution Provider (BSP). Run many numbers under one account and give each of your customers, brands or locations its own custom WhatsApp number.

Minimo is a **WhatsApp Business Solution Provider (BSP)** — we hold the 360dialog partner plan,
handle Meta onboarding and the BSP contract, and pass Meta's conversation fees through at cost.
That means you are not limited to a single WhatsApp number: you can run **many numbers under one
Minimo account**, each with its own display name and templates.

This is the model that lets a platform or agency **give every client, brand or location its own
custom WhatsApp number** — something few providers make easy.

## Who this is for

<CardGroup cols={2}>
  <Card title="Platforms & marketplaces" icon="layer-group">
    Your end-customers each want to message *their* users from *their own* branded number. Provision
    one per customer instead of sharing a single line.
  </Card>

  <Card title="Agencies & resellers" icon="handshake">
    Manage WhatsApp for a portfolio of brands from one place, and resell WhatsApp messaging without
    running your own BSP contract with Meta.
  </Card>

  <Card title="Multi-location businesses" icon="store">
    A dedicated number per shop, clinic or salon — replies and history stay separated per location.
  </Card>

  <Card title="Support + marketing split" icon="inbox">
    Keep a support line and a marketing line on different numbers (and, if you want, different WABAs).
  </Card>
</CardGroup>

## How it works

<Steps>
  <Step title="We provision the numbers">
    Minimo runs on a 360dialog **partner** plan that covers **unlimited numbers**. Adding another
    number does not add a per-number platform fee — you only pay Meta's usual conversation fees,
    billed to you at cost.
  </Step>

  <Step title="Connect each number">
    Each WhatsApp number is connected as a **sender** on a company, from **Settings → Connections**
    (or the **Channels** section). A single company can hold more than one number, across one or
    more WhatsApp Business Accounts (multi-sender / multi-WABA).
  </Step>

  <Step title="Pick the sender on every send">
    When you send, you choose which number the message goes out from with the `sender` field. Omit
    it and Minimo uses the company's **preferred** (default) number. See
    [List WhatsApp senders](/api-reference/messaging-channels/whatsapp/list-senders) and
    [Send a WhatsApp template](/api-reference/messaging-channels/whatsapp/send-template).
  </Step>
</Steps>

## Discover the numbers you can send from

The set of numbers a company may send from — with their display name and Meta `phone_number_id` —
is available from the API. This is the value you pass as `sender`:

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

Each item exposes the `phoneNumber`, the WhatsApp Business display name (`phoneName`), the Meta
`phoneNumberId`, and whether it is the company default (`isPreferred`). The response is redacted —
it never returns API keys, client IDs or webhook URLs. Full reference:
[List WhatsApp senders](/api-reference/messaging-channels/whatsapp/list-senders).

## Send from a specific number

```bash theme={null}
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": "appointment_confirmation",
      "components": [
        { "type": "BODY", "parameters": [ { "type": "text", "text": "Jane" } ] }
      ]
    }
  }'
```

<Tip>
  Pair a per-client number with a per-client [AI assistant](/product/messaging/whatsapp-assistant): each
  number can have its own assistant, knowledge base and actions, so every brand gets a fully separate
  WhatsApp presence.
</Tip>

<Warning>
  Passing a `sender` that isn't one of the company's connected numbers returns
  `WHATSAPP_SENDER_NOT_FOUND`. Always source the value from
  [List WhatsApp senders](/api-reference/messaging-channels/whatsapp/list-senders).
</Warning>

## Adding numbers at scale

Provisioning many numbers (per-customer onboarding, agency portfolios, white-label resale) is set up
with us directly — reach out at [info@minimo.it](mailto:info@minimo.it) and we'll wire up the numbers
and WABAs for your account. Once connected, they appear in
[List WhatsApp senders](/api-reference/messaging-channels/whatsapp/list-senders) and are usable
immediately via the `sender` field.