API & Developers

Build directly on the platform — REST API, webhooks, SDKs and MCP, documented in full.

API requests (30d)

1.2M

+34.1%

p95 latency

118ms

-22ms

Error rate

0.06%

-0.02pt

Active API keys

4

+1

Documentation

SDKs

JavaScript / TypeScript

Python

PHP

Go

Authentication

Every request is authenticated with a workspace API key sent as a bearer token. Keys are scoped to a single workspace and can be rotated without downtime.

curl https://api.nextaibot.in/v1/conversations \
  -H "Authorization: Bearer $NEXTAIBOT_API_KEY"

Endpoints

The most used routes

POST/v1/messagesSend a message on any connected channel
GET/v1/conversationsList conversations with filters and cursors
GET/v1/contacts/{id}Fetch a single contact with CRM fields
POST/v1/contactsCreate or upsert a contact
POST/v1/campaigns/{id}/sendTrigger a broadcast campaign
POST/v1/automations/{id}/runRun an automation for a contact
GET/v1/agentsList AI agents and their configuration
POST/v1/webhooksRegister a webhook subscription

Webhook events

message.receivedmessage.sentmessage.failedconversation.assignedconversation.resolvedcontact.createdcontact.updatedlead.createdlead.stage_changedorder.createdorder.paidreview.receivedautomation.completedcampaign.finished

Changelog

2026-08-12

MCP server registration endpoints

New

2026-07-28

Carousel template support in /v1/messages

New

2026-07-04

Cursor pagination on /v1/conversations

Changed

2026-06-19

Deprecated /v1/send — use /v1/messages

Deprecated

API keys

Productionnab_live_••••••••4f2aLast used 2 minutes agoActive
Stagingnab_test_••••••••91cdLast used 1 hour agoActive
Mobile appnab_live_••••••••2b77Last used 6 hours agoActive
Legacy importnab_live_••••••••0e13Last used 3 months agoPaused