Conversation API
The Conversation API provides endpoints for creating, retrieving, updating, and deleting conversations and their related resources—including participants (members), events, recordings, call legs, and user accounts—allowing developers to manage multi‑medium communication sessions programmatically.
Latency
416ms p95
Uptime
100.0% 30d
Playground
Verified
live
Endpoints
/conversations/{conversation_id}/members/{member_id}
Retrieve a member
/conversations/{conversation_id}/members/{member_id}
Update a member
/conversations/{conversation_id}/record
Record a conversation
/conversations/{conversation_id}/events/{event_id}
Retrieve an event
/conversations/{conversation_id}/members
List members
/conversations/{conversation_id}/members
Create a member
/conversations/{conversation_id}/members/{member_id}
Delete a member
/conversations
List conversations
/conversations
Create a conversation
/conversations/{conversation_id}
Delete a conversation
/conversations/{conversation_id}
Retrieve a conversation
/conversations/{conversation_id}
Update a conversation
/conversations/{conversation_id}/events
List events
/conversations/{conversation_id}/events
Create an event
/conversations/{conversation_id}/events/{event_id}
Delete an event
/legs
List legs
/legs/{leg_id}
Delete a leg
/users
List users
/users
Create a user
/users/{user_id}
Delete a user
/users/{user_id}
Retrieve a user
/users/{user_id}
Update a user
/users/{user_id}/conversations
List user conversations
23 endpoints auto-detected
Authentication
This API uses Bearer token authentication — pass your token in the Authorization header.
curl -X GET \
"https://api.nexmo.com/v0.1/conversations/{conversation_id}/members/{member_id}" \
-H "Authorization: Bearer YOUR_TOKEN"api.nexmo.com · HTTPS only