Log in to the Vonage API Dashboard and create a Voice application; in the application settings, set the Answer URL (the HTTP endpoint Vonage calls when an inbound call arrives) and the Event URL (for call lifecycle events) using HTTPS.
Navigate to SIP > SIP Dashboard and link your Voice application to a Vonage SIP domain (e.g., yoursubdomain.sip.vonage.com); your PBX or softphone registers to or routes calls through this domain.
For inbound calls, Vonage fetches your Answer URL and expects an NCCO (Nexmo Call Control Object) JSON array in response; return an NCCO with actions such as 'talk', 'connect', or 'record' to control the call flow.
For outbound calls via SIP, use the Vonage Voice API to create a call (POST to /v1/calls) with a to array specifying type: 'sip' and the target SIP URI, and a from object with your Vonage number.
Configure your PBX to authenticate with the Vonage SIP domain using the SIP credentials generated in the SIP Dashboard, or use IP-based authentication if your PBX has a fixed public IP.
Test connectivity by dialing the Vonage SIP domain from a registered SIP client and verifying that your Answer URL receives a POST request; inspect the event log in the Vonage Dashboard for detailed call traces.
Known gotchas
Vonage NCCOs must be returned with Content-Type: application/json; returning plain text or XML causes the call to fail with a Vonage internal error.
The Answer URL must respond within a few seconds; long-running database queries or external API calls before returning the NCCO can cause Vonage to time out and drop the call.
Vonage SIP trunking uses TLS for signaling and SRTP for media by default on current plans; ensure your PBX supports TLS SIP transport and SRTP, or check Vonage support documentation for plain UDP/RTP options if your PBX requires them.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp