# Ody developer docs

Source: https://dev.ody.co

Ody is an AI-native business phone (shared numbers, calling, SMS/MMS, and the Astra AI receptionist). These are its developer docs.

- REST API base URL: https://api.ody.co/v1/api — authenticate with `Authorization: Bearer ody_live_…` (or `ody_test_…` for test mode)
- MCP server (Streamable HTTP, JSON-RPC 2.0): https://api.ody.co/v1/mcp — same keys and scopes
- OpenAPI 3.1 spec (no auth): https://api.ody.co/v1/api/openapi.json
- Every page is also available as Markdown by appending `.md` to its URL.

## Get started

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

- [Introduction](https://dev.ody.co/get-started/introduction)
- [Quickstart](https://dev.ody.co/get-started/quickstart)
- [Core concepts](https://dev.ody.co/get-started/core-concepts)
- [Authentication](https://dev.ody.co/get-started/authentication)
- [Scopes](https://dev.ody.co/get-started/scopes)
- [Test mode](https://dev.ody.co/get-started/test-mode)

## REST API

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

- [REST API overview](https://dev.ody.co/api/overview)
- [Errors](https://dev.ody.co/api/errors)
- [Pagination](https://dev.ody.co/api/pagination)
- [Idempotency](https://dev.ody.co/api/idempotency)
- [Rate limits](https://dev.ody.co/api/rate-limits)
- [Contacts](https://dev.ody.co/api/contacts)
- [Conversations](https://dev.ody.co/api/conversations)
- [Messages](https://dev.ody.co/api/messages)
- [Calls](https://dev.ody.co/api/calls)
- [Numbers](https://dev.ody.co/api/numbers)
- [Messaging (10DLC)](https://dev.ody.co/api/messaging)
- [Agent](https://dev.ody.co/api/agent)
- [Webhook endpoints](https://dev.ody.co/api/webhook-endpoints)

## Webhooks

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

- [Webhooks overview](https://dev.ody.co/webhooks/overview)
- [Event types](https://dev.ody.co/webhooks/events)
- [Verifying signatures](https://dev.ody.co/webhooks/signatures)
- [Retries and delivery](https://dev.ody.co/webhooks/retries)

## MCP server

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

- [MCP server overview](https://dev.ody.co/mcp/overview)
- [Connect an MCP client](https://dev.ody.co/mcp/connect)
- [MCP tool reference](https://dev.ody.co/mcp/tools)
- [MCP safety and permissions](https://dev.ody.co/mcp/safety)
- [MCP protocol details](https://dev.ody.co/mcp/protocol)

## Guides

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

- [Send texts and handle replies](https://dev.ody.co/guides/send-your-first-text)
- [Agent Phone: give an AI agent a phone line](https://dev.ody.co/guides/agent-phone)
- [Run a live SMS agent](https://dev.ody.co/guides/live-sms-agent)

## SDKs

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

- [SDKs](https://dev.ody.co/sdks/overview)
- [TypeScript SDK](https://dev.ody.co/sdks/typescript)
- [Python SDK](https://dev.ody.co/sdks/python)

## Switchboard

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

- [Switchboard](https://dev.ody.co/switchboard/overview)
- [Plans and the build loop](https://dev.ody.co/switchboard/plans)
- [Switchboard actions](https://dev.ody.co/switchboard/actions)
- [Switchboard safety model](https://dev.ody.co/switchboard/safety)

## Resources

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

- [Docs for AI tools](https://dev.ody.co/resources/docs-for-ai)
- [Support and changelog](https://dev.ody.co/resources/support)