API Documentation

Build with the MARLO API

Access calls, contacts, analytics, and webhooks programmatically. RESTful API with full SDK support.

Authentication

Bearer token via API key

All API requests require a Bearer token in the Authorization header. Generate your API key from your dashboard under Settings > API Keys.

Authorization: Bearer marlo_sk_live_...

Quick start

curl -X GET "https://api.getmarlo.com/v1/calls" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

API Endpoints

Calls

GET/v1/callsList all calls with filtering and pagination
GET/v1/calls/:idGet details for a specific call
GET/v1/calls/:id/transcriptGet the full transcript of a call
GET/v1/calls/:id/recordingGet the audio recording URL

Contacts

GET/v1/contactsList all CRM contacts
POST/v1/contactsCreate a new contact
PATCH/v1/contacts/:idUpdate a contact
DELETE/v1/contacts/:idDelete a contact

Analytics

GET/v1/analytics/overviewGet high-level metrics and KPIs
GET/v1/analytics/callsGet call volume and trend data
GET/v1/analytics/sourcesGet call source attribution data

Webhooks

GET/v1/webhooksList configured webhooks
POST/v1/webhooksCreate a new webhook endpoint
DELETE/v1/webhooks/:idRemove a webhook