The identities this workspace can send from, on any channel

curl --request GET \
  --url https://{subdomain}.mihu.ai/api/v1/senders \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{subdomain}.mihu.ai/api/v1/senders', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{subdomain}.mihu.ai/api/v1/senders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{subdomain}.mihu.ai/api/v1/senders"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{subdomain}.mihu.ai/api/v1/senders")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Senders retrieved successfully",
  "data": [
    {
      "identifier": "13204296811",
      "display_name": "Mindhunters",
      "channel": "whatsapp",
      "agent_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent_name": "<string>",
      "answered_by": {
        "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "Serap"
      },
      "endpoint_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "waba_id": "<string>",
      "status": "active",
      "sendable": true,
      "queues": [
        {
          "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "Support"
        }
      ],
      "agents": [
        {
          "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "sendable": true
        }
      ]
    }
  ]
}

Senders

The identities this workspace can send from, on any channel

One list of everything an outbound conversation can leave from: WhatsApp numbers, SMS numbers, outbound caller IDs and email addresses. Every entry has the same shape — only identifier changes meaning (a phone number, or an email address).

When to use it. Before starting a new outbound conversation, so the operator chooses what the customer sees. A workspace usually owns several numbers, they need not belong to the same WhatsApp Business Account, and contacting somebody from a number they have never seen — while an open thread sits on another one — is how outbound goes wrong.

What to send with. agent_uuid is the send identity for whatsapp, sms and call: it is what POST /whatsapp/template takes as agentId, and what GET /whatsapp/templates?agent_uuid= narrows the catalogue by. Email is the exception — there the send identity is the mailbox itself, so pass endpoint_uuid as from to POST /email/messages. Both fields are always present, so a caller can hold one field per channel without special-casing the rest of the object.

Why WhatsApp needs the number chosen first. Templates are approved per WABA. Picking the number and then listing templates for that same agent_uuid is what stops a send being rejected by Meta after the operator has already written the message.

sendable. True when the sender can actually originate: it is bound to an agent, has what the provider needs (a Meta phone number id, a number, an address), and is not in a state that blocks sending. A receive-only endpoint comes back sendable: false with agent_uuid: null — show it disabled rather than hiding it, so the gap stays visible to whoever administers the workspace. Statuses we do not recognise count as sendable, so an unfamiliar provider value never hides a working sender.

Channels covered. whatsapp, sms, call, email. Facebook and Instagram are deliberately absent — the sender there is a page identity, not something an operator picks.

Who can call it, and how much of it they see. A workspace API token, or a per-user JWT holding loop.templates.send. A workspace token — and an admin or the workspace owner on a JWT — gets every sender. Any other per-user JWT gets only the senders routed to an ACTIVE queue that user is a member of: the same membership rule the inbox reads by, so an operator is never offered a number whose replies would land in somebody else’s queue. A sender routed to no queue at all is workspace/admin-only, exactly like an unassigned conversation.

GET

api

senders

The identities this workspace can send from, on any channel

curl --request GET \
  --url https://{subdomain}.mihu.ai/api/v1/senders \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{subdomain}.mihu.ai/api/v1/senders', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{subdomain}.mihu.ai/api/v1/senders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{subdomain}.mihu.ai/api/v1/senders"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{subdomain}.mihu.ai/api/v1/senders")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Senders retrieved successfully",
  "data": [
    {
      "identifier": "13204296811",
      "display_name": "Mindhunters",
      "channel": "whatsapp",
      "agent_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent_name": "<string>",
      "answered_by": {
        "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "Serap"
      },
      "endpoint_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "waba_id": "<string>",
      "status": "active",
      "sendable": true,
      "queues": [
        {
          "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "Support"
        }
      ],
      "agents": [
        {
          "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "sendable": true
        }
      ]
    }
  ]
}

Authorizations

Authorization

string

header

required

Use a Bearer token to access these API endpoints. Example: "Bearer {your-token}"

Query Parameters

channel

enum<string>

Restrict to one channel. Omit for every channel at once.

Available options:

whatsapp,

sms,

call,

email

sendable_only

boolean

default:false

Only senders that can originate a message

queue_uuid

string<uuid>

Only senders routed to this queue

distinct

enum<string>

identifier collapses the list to one row per address. Use it when the picker is about the number the customer sees rather than which agent sends — on voice a caller ID can be bound to several agents. The surviving row is chosen by a fixed rule (sendable first, then the agent the queue designer routes that endpoint to, then the oldest binding), so the same address always resolves to the same agent_uuid. Collapsed rows carry an agents array listing everyone bound to that address.

Available options:

identifier

Response

Senders retrieved

success

boolean

Example:

true

message

string

Example:

"Senders retrieved successfully"

data

object[]

Show child attributes

API Documentation

API Reference

The identities this workspace can send from, on any channel

Authorizations

Query Parameters

Response