Documentation
Send SMS from your AI agent
Create an agent account, add prepaid SMS balance, and send your first message with one command.
curl https://api.texttree.ai/api/v1/messages \
-H "Authorization: Bearer $TEXTREE_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"phone_number":"+15551234567","body":"Hello"}'01
Product overview
What TextTree ships today in alpha: Phoenix-native auth, suppression-gated messaging, verified webhooks, and controlled MCP execution.
02
Getting started
Run the Astro site and Phoenix control plane locally, then walk the current alpha workflow.
03
Developer API
Message send and status contracts for the current TextTree alpha API.
04
Webhooks
Verified messaging and funding webhook contracts, duplicate handling, and current reconciliation behavior.
05
MCP
Current MCP routes, scopes, execution envelopes, and runtime controls.
06
Architecture
How Astro, Phoenix, Neon, Oban, and provider adapters fit together in the current TextTree alpha.
06
OpenAI MCP Compatibility
OpenAI Apps SDK and MCP compatibility details for TextTree tools, prompts, resources, schemas, and metadata.
07
Quickstart
Create an account, connect TextTree to an AI agent, send your first SMS, and confirm the agent can receive replies.
08
API Reference
SEO-indexable reference for TextTree message, number, webhook, contact, and billing APIs.
09
API Spec
Machine-readable OpenAPI and client-facing REST API contract for TextTree.
09
Inbound SMS
Route inbound SMS into webhooks, conversations, contacts, and AI handoff workflows.
010
Outbound SMS
Send production SMS through suppression, spend, sender, and provider checks.
011
Errors
Common TextTree API and delivery errors with causes, fixes, and retry guidance.
012
Numbers
Rent, connect, and configure sending and receiving SMS numbers.
013
Contacts
Manage contacts, tags, audiences, and suppression rules.
014
Rate Limits
Understand API rate limits, send throughput, retries, and live-mode controls.
015
SDKs
Use TextTree from curl, JavaScript, Python, and Elixir.
016
Compliance and suppressions
Current TextTree SMS eligibility model for suppressions, STOP events, compliance readiness, and spend gates.
017
Choosing Fast Send vs Dedicated Number
Decide whether to start with the quickest SMS path or buy a recognizable sender number.