# Telnyx Messaging

> SMS, MMS, 10DLC, toll-free, short code, and RCS messaging on a
> carrier-owned global network. Two-way messaging with delivery receipts,
> long-code throughput, and direct carrier connections in 100+ countries.

## What this surface is for
- Sending SMS/MMS programmatically via api.telnyx.com/v2/messages
- Provisioning messaging profiles, 10DLC brands and campaigns
- Configuring inbound webhooks and delivery receipt callbacks
- Looking up messaging pricing per region and number type

## Canonical docs and APIs
- Messaging pricing and overview: https://telnyx.com/pricing/messaging
- Messaging API reference: https://developers.telnyx.com/api/messaging
- Messaging product docs: https://developers.telnyx.com/docs/messaging
- 10DLC docs: https://developers.telnyx.com/docs/messaging/10dlc
- Pricing markdown: https://telnyx.com/pricing.md
- OpenAPI spec: https://raw.githubusercontent.com/team-telnyx/openapi/master/openapi/spec3.json

## Authentication
- Bearer API key in Authorization header. Get a key via the agent signup
  flow: https://telnyx.com/agent-signup.md

## Recovery
- Errors return a top-level errors[] array with code, title, detail, and
  (where available) meta.url linking to error documentation.
- Retry transient failures on HTTP 429 (respect Retry-After) and on
  documented transient 5xx (502, 503, 504). Do not retry other 4xx.
- Inbound webhook delivery has built-in retries with exponential backoff.
- Delivery receipts: see https://developers.telnyx.com/docs/messaging/reports-and-records

## Agent fast path
- Agent entry point: https://telnyx.com/agents/start
- Site-wide index: https://telnyx.com/llms.txt
- API namespace index: https://telnyx.com/api/llms.txt