Developer

API Reference

Build with MobDial's REST APIs. Full programmatic access to calls, contacts, campaigns, messaging, recordings, compliance, and webhooks.

Quick Start

Get started

Base URLhttps://api.mobdial.com/v1
AuthenticationBearer token
Rate Limit1,000 req/min
Endpoints

API endpoints

Calls

Place, retrieve, update, and hang up calls. Access recordings, transcripts, and quality scores.

POST/v1/calls
GET/v1/calls/:id
PATCH/v1/calls/:id
DELETE/v1/calls/:id

Contacts

Create, list, update, and delete contacts. Search by phone, email, name, or custom fields.

POST/v1/contacts
GET/v1/contacts
PATCH/v1/contacts/:id
DELETE/v1/contacts/:id

Campaigns

Create and manage dialer campaigns. Configure dialer mode, agent assignments, and compliance profiles.

POST/v1/campaigns
GET/v1/campaigns
PATCH/v1/campaigns/:id
POST/v1/campaigns/:id/start

SMS

Send and receive SMS messages. Manage threads, opt-outs, and delivery status.

POST/v1/sms
GET/v1/sms/:id
GET/v1/sms/threads

Recordings

List, retrieve, and delete call recordings. Download audio files and access transcripts.

GET/v1/recordings
GET/v1/recordings/:id
DELETE/v1/recordings/:id

DNC

Manage Do Not Call records. Check numbers against federal, state, and internal DNC lists.

POST/v1/dnc
GET/v1/dnc/check/:phone
DELETE/v1/dnc/:id

Webhooks

Register webhook endpoints for real-time event notifications. Configure retry policies and event filters.

POST/v1/webhooks
GET/v1/webhooks
PATCH/v1/webhooks/:id
DELETE/v1/webhooks/:id

Example request

# Create a contact and get the response
curl -X POST https://api.mobdial.com/v1/contacts \
  -H "Authorization: Bearer mk_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jane",
    "last_name": "Smith",
    "phone": ["+14155551234"],
    "email": ["jane@acme.com"],
    "company": "Acme Corp"
  }'
# Response (201 Created)
{
  "contact_id": "ct_9f8e7d6c5b4a",
  "first_name": "Jane",
  "last_name": "Smith",
  "phone": ["+14155551234"],
  "email": ["jane@acme.com"],
  "company": "Acme Corp",
  "lead_score": 0,
  "dnc": false,
  "created_at": "2026-03-22T10:30:00Z"
}

Official SDKs

Type-safe client libraries with automatic retries, pagination helpers, and comprehensive documentation.

Node.jsPythonGoRuby

Ready to integrate?

Get your API key and start building in minutes. Free tier includes 1,000 API calls per day.

Get API KeyRead Full Docs