OdyDocs

Ody developer docs

Build on the business phone

Text, call, buy numbers, register 10DLC, and run the Astra AI receptionist from your own code — or hand the whole workspace to an AI assistant over MCP. Everything you do here lands in the same account your team uses in the app.

Base URL
api.ody.co/v1/api
MCP endpoint
api.ody.co/v1/mcp
Auth
Bearer ody_live_… / ody_test_…
Rate limit
600 requests / min / key
curl https://api.ody.co/v1/api/messages \
  -H "Authorization: Bearer ody_test_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042-shipped" \
  -d '{"to":"+15125550123","body":"Your order shipped!"}'

What does what

Five surfaces, one permission model: every call acts as the workspace member who created the key.

Get started

What each developer surface does, your first API call, keys, scopes, and test mode.

REST API

Contacts, conversations, messages, calls, numbers, 10DLC, your AI agent, and webhooks over HTTPS.

Webhooks

Get pushed every new message, call outcome, and contact change — signed per Standard Webhooks.

MCP server

Plug your Ody workspace into Claude, ChatGPT, Cursor, or any Model Context Protocol client.

Guides

End-to-end recipes: your first text, a full AI phone line from code, a live SMS agent.

SDKspreview

Zero-dependency TypeScript and Python clients with pagination, typed errors, and webhook verification.

Switchboardpreview

Describe a phone-system change in plain words; Ody plans it, you approve it, Ody builds it.

Resources

Docs for AI tools (llms.txt, Markdown pages), and how to get help.