Developer API

Build on the same network that carries your calls and texts. Send and receive texts from your Ahoy numbers, text callers back from your phone system, and stream live call audio into your own software, all with one API key.

One API for voice and messaging

Messaging: SMS and MMS

Send SMS and MMS from your Ahoy numbers with one request to POST /v1/messages. Replies and delivery receipts arrive at your webhook as JSON, and MMS attachments download from a link in each event.

  • Inbound replies and delivery receipts by webhook, signed so you can verify them
  • STOP, HELP and opt-in keywords handled for you
  • $0.01 per SMS segment and $0.03 per MMS message, carrier fees included

Text Back

Text a caller the message stored on your account, such as a payment link, office hours or directions, with one request to POST /v1/textback and the caller’s number. Trigger it from your call flow in a phone system such as 3CX.

  • The text comes from your business number
  • A repeat request for the same caller is skipped, so nobody gets the same text twice

Live Call Audio

Stream both sides of every call on your Ahoy SIP trunk to your app in real time over a secure WebSocket. Build live transcripts, AI agent assist, call coaching or analytics on top.

  • Works with any phone system on your trunk
  • Twilio Media Streams compatible
  • Optional live transcripts with your own xAI or OpenAI key
  • Free with your trunk

Send a text in one request

curl -X POST https://api.ahoy.tel/v1/messages \
  -H "Authorization: Bearer $AHOY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "+17205550100",
    "to": "+13035550123",
    "text": "Hi Sam, your order is ready for pickup.",
    "reference": "go-msg-88231"
  }'

The response returns the message ID and how many segments it used. Delivery receipts follow at your webhook. See the docs for every field.

Built for developers

  • One API key. Every request carries the same key as a Bearer token. Create it in the Ahoy portal and keep it on your server.
  • Signed webhooks. Each webhook carries an HMAC-SHA256 signature you check with your signing secret. The docs include Node.js and Python examples.
  • OpenAPI spec. Import openapi.yaml into your own tools.
  • Clear errors. A consistent error format with standard HTTP status codes, including a clear signal when to back off and retry.
  • Encrypted connections. HTTPS for the REST API and wss:// for live call audio.

Start building

Already an Ahoy customer? Create an API key in the portal and you’re ready to go.

New to Ahoy? Tell us what you’re building and we’ll set you up with numbers and SIP trunks.