# TidyMessages Docs

Build, connect, and operate customer messaging with TidyMessages.

Full corpus (all pages, one document): https://support.tidymessages.com/llms-full.txt

## Pages

- [Apple Messages capabilities](https://support.tidymessages.com/amb-capabilities/index.md) — Render only actions reported by the activated connection.
- [Apple Messages for Business](https://support.tidymessages.com/amb-overview/index.md) — Understand Apple approval and private TidyMessages activation.
- [Set up Apple Messages for Business](https://support.tidymessages.com/amb-setup/index.md) — Prepare Apple registration and validate a privately activated connection.
- [API overview](https://support.tidymessages.com/api-overview/index.md) — Learn HTTP conventions, authentication, identifiers, and compatibility rules.
- [API reference](https://support.tidymessages.com/api-reference/index.md) — Request and response contracts for the TidyMessages HTTP API.
- [Attachments API](https://support.tidymessages.com/attachments-api/index.md) — Request controlled uploads and inspect media processing state.
- [Send attachments](https://support.tidymessages.com/attachments/index.md) — Upload, validate, and attach supported media.
- [Authentication](https://support.tidymessages.com/authentication/index.md) — Protect and use scoped server-side API tokens.
- [Availability and feature status](https://support.tidymessages.com/availability/index.md) — Read the meaning of Available, Preview, Requires activation, Planned, and Unavailable.
- [Capabilities API](https://support.tidymessages.com/capabilities-api/index.md) — Query actions currently permitted for a connection or conversation.
- [Changelog](https://support.tidymessages.com/changelog/index.md) — Track help center and generally visible platform updates.
- [Channels overview](https://support.tidymessages.com/channels-overview/index.md) — Compare activation, capabilities, and operational boundaries across channels.
- [Channels](https://support.tidymessages.com/channels/index.md) — Understand channel capabilities, activation requirements, and operational limits before connecting a provider.
- [Connection lifecycle](https://support.tidymessages.com/connection-lifecycle/index.md) — Control activation, degradation, suspension, and disconnection safely.
- [Connections API](https://support.tidymessages.com/connections-api/index.md) — Read safe channel identity, readiness, and capability metadata.
- [Contact support](https://support.tidymessages.com/contact-support/index.md) — Send safe diagnostic context to the Grid Heap support team.
- [Conversations API](https://support.tidymessages.com/conversations-api/index.md) — Create threads and manage supported workflow fields.
- [Work with conversations](https://support.tidymessages.com/conversations/index.md) — Create durable threads and manage workflow state.
- [Core concepts](https://support.tidymessages.com/core-concepts/index.md) — Learn the resources shared across messaging channels.
- [Data retention](https://support.tidymessages.com/data-retention/index.md) — Minimize content and align deletion across downstream systems.
- [Understand delivery states](https://support.tidymessages.com/delivery-states/index.md) — Reconcile queued, submitted, delivered, read, and failed messages.
- [Email overview](https://support.tidymessages.com/email-overview/index.md) — Map email content and threading into the shared conversation model.
- [Set up email](https://support.tidymessages.com/email-setup/index.md) — Validate sender identity, inbound routing, and delivery controls.
- [Environments](https://support.tidymessages.com/environments/index.md) — Separate test and production traffic, data, and credentials.
- [Handle errors](https://support.tidymessages.com/error-handling/index.md) — Use stable error codes and safe request identifiers.
- [Error model](https://support.tidymessages.com/errors-api/index.md) — Handle stable codes, retryability, and request identifiers.
- [Glossary](https://support.tidymessages.com/glossary/index.md) — Look up the shared vocabulary used across TidyMessages.
- [Guides](https://support.tidymessages.com/guides/index.md) — Practical patterns for conversations, delivery, webhooks, retries, security, and production readiness.
- [Health API](https://support.tidymessages.com/health-api/index.md) — Inspect service and connection readiness without sensitive data.
- [Use idempotency keys](https://support.tidymessages.com/idempotency/index.md) — Make outbound retries safe without creating duplicate messages.
- [Run the iMessage local bridge](https://support.tidymessages.com/imessage-local-bridge/index.md) — Prepare a controlled macOS host and verify bridge readiness.
- [iMessage preview](https://support.tidymessages.com/imessage-overview/index.md) — Learn the boundary of the controlled local-hosted bridge.
- [Troubleshoot the iMessage bridge](https://support.tidymessages.com/imessage-troubleshooting/index.md) — Separate host, permission, account, and service failures.
- [Incident readiness](https://support.tidymessages.com/incident-readiness/index.md) — Prepare a channel-aware response and recovery runbook.
- [Introduction](https://support.tidymessages.com/introduction/index.md) — Understand the TidyMessages platform and its channel-aware conversation model.
- [Messages API](https://support.tidymessages.com/messages-api/index.md) — Create, retrieve, and list messages and delivery state.
- [Migration notes](https://support.tidymessages.com/migration-notes/index.md) — Move workflows by mapping behavior and validating one connection at a time.
- [Observability](https://support.tidymessages.com/observability/index.md) — Monitor requests, queues, webhooks, connections, and retries safely.
- [Operations](https://support.tidymessages.com/operations/index.md) — Run TidyMessages reliably with connection controls, observability, retention, and incident procedures.
- [Pagination contract](https://support.tidymessages.com/pagination-api/index.md) — Use bounded page sizes and opaque cursors.
- [Paginate collections](https://support.tidymessages.com/pagination/index.md) — Traverse changing collections with opaque cursors.
- [Manage participants](https://support.tidymessages.com/participants/index.md) — Handle participant identity and sensitive channel addresses safely.
- [Production readiness](https://support.tidymessages.com/production-readiness/index.md) — Complete the operational checklist before live traffic.
- [Provider delivery](https://support.tidymessages.com/provider-delivery/index.md) — Separate API acceptance from final channel delivery.
- [Quickstart](https://support.tidymessages.com/quickstart/index.md) — Send a first test message and follow its delivery state.
- [Handle rate limits](https://support.tidymessages.com/rate-limits/index.md) — Control concurrency and back off safely after throttling.
- [Resources](https://support.tidymessages.com/resources/index.md) — Release notes, terminology, migration guidance, roadmap boundaries, and support contacts.
- [Design retry handling](https://support.tidymessages.com/retry-handling/index.md) — Retry only safe operations with bounded backoff and jitter.
- [SDKs and tools](https://support.tidymessages.com/sdks-and-tools/index.md) — Choose safe tools and preserve HTTP API semantics.
- [Security and privacy](https://support.tidymessages.com/security-privacy/index.md) — Minimize sensitive data and protect credentials and customer content.
- [Send your first message](https://support.tidymessages.com/send-first-message/index.md) — Validate readiness, submit safely, and handle asynchronous acceptance.
- [Start here](https://support.tidymessages.com/start-here/index.md) — Learn the platform model, create a safe test environment, and make your first API request.
- [Support and escalation](https://support.tidymessages.com/support-escalation/index.md) — Share reproducible, safe diagnostics without customer content or secrets.
- [Test in the sandbox](https://support.tidymessages.com/testing-sandbox/index.md) — Exercise delivery and failure paths with synthetic data.
- [Troubleshooting](https://support.tidymessages.com/troubleshooting/index.md) — Locate failures using environment, connection, request, and event boundaries.
- [Unsupported or planned features](https://support.tidymessages.com/unsupported-planned/index.md) — See which commonly discussed features are not generally callable.
- [Verify webhooks](https://support.tidymessages.com/webhook-verification/index.md) — Authenticate raw event bytes before any side effect.
- [Webhooks API](https://support.tidymessages.com/webhooks-api/index.md) — Consume signed asynchronous event envelopes safely.
- [WhatsApp overview](https://support.tidymessages.com/whatsapp-overview/index.md) — Understand credentials, validation, service windows, and templates.
- [Set up WhatsApp](https://support.tidymessages.com/whatsapp-setup/index.md) — Connect an eligible business identity through the approved workflow.
- [Use WhatsApp templates](https://support.tidymessages.com/whatsapp-templates/index.md) — Send provider-approved templates with validated parameters.
- [Troubleshoot WhatsApp](https://support.tidymessages.com/whatsapp-troubleshooting/index.md) — Diagnose credentials, approval, template, policy, and webhook failures.