Overview

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:

Operation	Limit
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

Conversations

Unified call + SMS timeline with date filtering, keyword search, and rich contact data

Webhooks

Real-time event notifications with HMAC signatures and automatic retries

Phone Numbers

Your Allo numbers with capabilities, sender ID status, and member access

Users

Team roster with roles and assigned numbers

API

Webhooks

Conversations

People

Companies

Deals

Phone Numbers

Tags

Summary Templates

Users

SMS

Analytics

Power Dialer

Partner

Getting started

API documentation

Authentication

Rate limits

Pagination

Error handling

Core capabilities

Authentication

Rate limiting

Quick example

Endpoints

Conversations

Webhooks

Phone Numbers

Users

Tags

​Getting started

​API documentation

Authentication

Rate limits

Pagination

Error handling

​Core capabilities

​Authentication

​Rate limiting

​Quick example

​Endpoints

Conversations

Webhooks

Phone Numbers

Users

Tags

Getting started

API documentation

Core capabilities

Authentication

Rate limiting

Quick example

Endpoints