List WhatsApp inboxes
List the WhatsApp inboxes connected to the project, oldest first. Each inbox represents a connected WhatsApp number and includes its id, inbox_type, project_id, display name, config, created_at, and the agent answering on it. Use the returned id as the inbox_id for the other WhatsApp endpoints.
curl --request GET \
--url 'https://api.nabrah.ai/api/ext/omni_v2/whatsapp/inboxes' \
--header 'X-API-Key: <your-api-key>'{
"inboxes": [
{
"id": "00000000-0000-4000-8000-000000000000",
"inbox_type": "whatsapp",
"project_id": "00000000-0000-4000-8000-000000000000",
"name": "string",
"config": {},
"created_at": "2026-01-15T12:00:00.000Z",
"inbox_id": 0,
"chatbot_agent_id": "00000000-0000-4000-8000-000000000000",
"chatbot_agent_name": "string"
}
],
"max_inboxes": 0
}Where inbox IDs come from
This is the canonical source for inbox_id values used by other WhatsApp endpoints.
inboxes[].idThe UUID of each WhatsApp inbox. Pass it as inbox_id to the other WhatsApp endpoints, or as the {inbox_id} path parameter to GET full inbox details.
idinbox_typeproject_idnameconfigcreated_atinboxes[].inbox_idA numeric id for the number. Conversations carry the same value in their inbox_id field, so you can tell which number a conversation came in on. Do not pass it as inbox_id to other endpoints.
inbox_idThe agent auto-replying on the number, or null when none is assigned.
chatbot_agent_idchatbot_agent_namemax_inboxesHow many WhatsApp numbers the project may connect. Contact support to raise it.
max_inboxesconfig.connection_method is embedded_signup for numbers connected through Meta sign-in in the app, and is absent for numbers connected with their credentials. Numbers connected through Meta sign-in also include config.verified_name and config.name_status (the display name and its review status). config.meta_disconnected is true when access to the number was removed in Meta; reconnect it from the app to keep its conversations and settings.
config.connection_methodconfig.verified_nameconfig.name_statusconfig.meta_disconnectedAuthorization
X-API-KeystringheaderrequiredYour workspace API key. Create one in the dashboard under API keys.
Response
Successful Response
application/json