API Reference

Complete documentation for all Nexafone CPaaS APIs. Build powerful communication features with our comprehensive API suite.

Quick Start

1. Get Your API Key

Sign up for a free account and get your API key from the dashboard.

Get API Key

2. Make Your First Request

curl -X POST \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"to": "+1234567890"}' \
https://api.nexafone.com/v1/calls

Voice API

Make and receive voice calls programmatically

POST/v1/calls

Initiate a new voice call

GET/v1/calls/{call_id}

Get call details and status

POST/v1/calls/{call_id}/hangup

Hang up an active call

SMS API

Send and receive SMS messages globally

POST/v1/messages

Send an SMS message

GET/v1/messages/{message_id}

Get message delivery status

GET/v1/messages

List all messages

Video API

Build video calling and conferencing features

POST/v1/rooms

Create a video room

POST/v1/rooms/{room_id}/participants

Add participant to room

GET/v1/rooms/{room_id}

Get room details

WhatsApp Business API

Send messages via WhatsApp Business

POST/v1/whatsapp/messages

Send WhatsApp message

GET/v1/whatsapp/messages/{message_id}

Get message status

POST/v1/whatsapp/templates

Create message template

Verify API

Phone number verification and authentication

POST/v1/verify/start

Start verification process

POST/v1/verify/check

Verify the code

GET/v1/verify/{request_id}

Get verification status

Authentication

API Key Authentication

All API requests require authentication using your API key. Include it in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Rate Limits

  • • Free tier: 100 requests/minute
  • • Professional: 1,000 requests/minute
  • • Enterprise: Custom limits
  • • Rate limit headers included in responses

Webhooks

Real-time Events

Receive real-time notifications about call status, message delivery, and other events:

  • • Call status updates
  • • Message delivery receipts
  • • Verification completions
  • • Error notifications

Webhook Security

Secure your webhooks with signature verification:

X-Nexafone-Signature: sha256=...

Ready to Start Building?

Get your API key and start building amazing communication experiences today.