API Reference

Integrate NeoDialer into your applications with our REST API. Manage calls, campaigns, contacts, and more programmatically.

Base URL

https://api.dialer.neomd.health

Authentication

All API requests require authentication via Bearer token. Include your API key in the Authorization header:

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

Endpoints Overview

MethodEndpointDescription
POST
/v1/callsInitiate a new outbound call
GET
/v1/callsList all calls with pagination
GET
/v1/calls/:idGet details of a specific call
POST
/v1/campaignsCreate a new campaign
GET
/v1/campaignsList all campaigns
POST
/v1/contacts/importBulk import contacts from CSV
POST
/v1/webhooksCreate a webhook subscription

Webhook Events

Subscribe to real-time events from NeoDialer. Configure your webhook endpoint in Settings → Webhooks.

call.initiated

A new call has been initiated

call.answered

Call was answered by the contact

call.completed

Call ended normally

call.failed

Call failed to connect

campaign.started

Campaign started dialing

campaign.completed

Campaign finished all contacts

transcription.ready

Call transcription is available

SDKs & Libraries

Official SDKs to make integration easier:

Node.js

@neomd/dialer-sdkView on GitHub

Python

neomd-dialerView on GitHub

PHP

neomd/dialer-phpView on GitHub