Skip to main content
The Allo API enables developers to integrate Allo’s communication capabilities directly into their applications. Build CRM integrations, automate post-call workflows, sync conversation data, and power AI agents with your team’s call and SMS history.

​
Getting started

Before using the API, make sure you have:
  • An active Allo subscription
  • Admin or Manager permissions on your workspace
  • An API key generated from Settings > API

​
API documentation

Authentication

API key setup and scopes

Rate limits

Request limits and headers

Pagination

Page-based results with total counts

Error handling

Error format and recovery

​
Core capabilities

The API provides access to:
  • Conversations — retrieve call and SMS history in a unified timeline, with keyword search across transcripts and message content
  • Webhooks — receive real-time notifications when calls complete, messages arrive, tags are added, and contacts change
  • Phone numbers — list your Allo numbers with capabilities, sender ID status, and member access
  • Users — access your team roster with roles and assigned numbers
  • Tags — discover available call tags for filtering and reporting

​
Authentication

API keys are generated through your workspace settings. Include the key in the Authorization header of every request: 
curl -X GET "https://api.withallo.com/v2/api/conversations" \
  -H "Authorization: Api-Key ak_live_your_key_here"
Store your API key securely. Do not expose it in client-side code or public repositories.

​
Rate limiting

Rate limits vary by request type:
OperationLimit
Read requests (GET)20 requests/second
Write requests (POST, PUT, PATCH, DELETE)5 requests/second
Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers so you can monitor your usage. See Rate limits for details.

​
Quick example

Get your recent conversations: 
curl -X GET "https://api.withallo.com/v2/api/conversations?size=5" \
  -H "Authorization: Api-Key ak_live_your_key_here"

{
  "data": [
    {
      "contact_number": "+14155551234",
      "contacts": [{ "id": "cnt-abc", "name": "Sarah Johnson", "company": { "name": "Acme Corp" } }],
      "last_activity": "2026-04-21T14:30:00Z",
      "last_item": { "id": "cll-abc123", "type": "CALL", "direction": "INBOUND", "result": "ANSWERED", "summary": "Customer called about upgrading their plan.", "duration": 145 }
    }
  ],
  "pagination": { "page": 1, "size": 5, "total_count": 156, "has_more": true }
}

​
Endpoints

https://mintcdn.com/themobilefirstcompany/RgYoir1kmfhXIZ06/media/allo-icons/Phone.svg?fit=max&auto=format&n=RgYoir1kmfhXIZ06&q=85&s=83bbcaf90dae5f30887cdfbc503d97b2

Conversations

Unified call + SMS timeline with date filtering, keyword search, and rich contact data
https://mintcdn.com/themobilefirstcompany/0w3bVWjKfZPY4i7y/media/integrations/Webhooks.svg?fit=max&auto=format&n=0w3bVWjKfZPY4i7y&q=85&s=d2fc254143963c5ea1caa09b613bd22e

Webhooks

Real-time event notifications with HMAC signatures and automatic retries
https://mintcdn.com/themobilefirstcompany/RgYoir1kmfhXIZ06/media/allo-icons/Phone.svg?fit=max&auto=format&n=RgYoir1kmfhXIZ06&q=85&s=83bbcaf90dae5f30887cdfbc503d97b2

Phone Numbers

Your Allo numbers with capabilities, sender ID status, and member access
https://mintcdn.com/themobilefirstcompany/RgYoir1kmfhXIZ06/media/allo-icons/Contacts.svg?fit=max&auto=format&n=RgYoir1kmfhXIZ06&q=85&s=21e8763f48b29af6190da3bcc331ba89

Users

Team roster with roles and assigned numbers
https://mintcdn.com/themobilefirstcompany/yN5XCm7zDDPr0-yn/media/allo-icons/chat-bubble.svg?fit=max&auto=format&n=yN5XCm7zDDPr0-yn&q=85&s=d1817ba8f8b3a0d440cf67199eb899cd

Tags

Available call tags for filtering conversations