Skip to main content
The Adraa Inbox API is a REST API served over HTTPS. Requests and responses use JSON.

​
Base URL

https://api.inbox.adraa.ai

​
Authentication

Every request requires a workspace API token in the Authorization header: 
curl https://api.inbox.adraa.ai/api/v1/me \
  -H "Authorization: Bearer adraa_..."
Workspace admins create tokens in Settings → API. See Authentication for the full setup guide.

​
Errors

All errors share one envelope: 
{
  "error": {
    "code": "CONVERSATION_NOT_FOUND",
    "message": "Conversation not found"
  }
}
Validation failures include field-level details: 
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request data",
    "details": [{ "field": "body", "message": "Message body cannot be empty" }]
  }
}
Common codes:
StatusCodeMeaning
400VALIDATION_ERRORThe request body failed validation. Check details.
400WHATSAPP_SERVICE_WINDOW_CLOSEDWhatsApp’s 24-hour reply window has closed for this conversation.
400LAST_ADMINThe change would leave the workspace without an admin.
400AGENT_MANAGEDThe agent is managed by Adraa Inbox (the AI agent) and can’t be changed.
401MISSING_TOKENNo Authorization header was sent.
401INVALID_API_TOKENThe token is unknown or has been revoked.
403COMPANY_MISMATCHThe agent belongs to a different workspace than the conversation.
404CONVERSATION_NOT_FOUNDThe conversation does not exist in your workspace.
404AGENT_NOT_FOUNDThe agent is not an active member of your workspace.
409AGENT_ALREADY_MEMBERThe email already belongs to a workspace member.
409NICKNAME_TAKENThe display name is already in use across Adraa Inbox.
429RATE_LIMIT_EXCEEDEDToo many requests. Back off and retry.
A 404 is returned for conversations that exist but belong to another workspace. The API never reveals whether a resource exists outside the token’s workspace.

​
Rate limits

Write endpoints (assign, send message) accept 60 requests per minute. All other endpoints accept 100 requests per minute per IP. Exceeding a limit returns 429 RATE_LIMIT_EXCEEDED.

​
IDs

Resources use cuid identifiers like cmbxgz9pq0003ph01m4n5o6p7. To find a conversation’s ID, open it in the agent console — it’s the last segment of the URL: 
https://app.inbox.adraa.ai/<workspace>/conversations/<conversationId>