Choose which number the API sends from

Released 31 July 2026

If you build on our API and your workspace has more than one WhatsApp number, you can now list those numbers and say which one a message should come from.

What's new

• List your senders — a new endpoint returns every number your workspace can send from, with its status and the WhatsApp Business Account it sits under. Only a connected number can send, and the list says which those are, so a "send as" menu in your own app never offers a number the send would refuse.
• Say which number a message comes from — a send can now name the number it should go out as. It is honoured exactly: if the number you name isn't yours or isn't connected, the send is refused rather than quietly going out from a different one.
• Nothing changes unless you ask for it — leave the new field out and sends behave exactly as they always have: they reply on the number the conversation came in on, then your default number.
• Templates say which account they belong to — every template now comes back with the business account it was created on, and the list can be filtered to one. A template can only be sent from a number on its own account, so this is how you show only the templates the chosen number can actually send.
• The published API reference is up to date — the spec you import into Postman or Apidog now describes everything the API accepts, including the newer email and multi-channel send fields.