Conversations

SMS inbox conversations with replies and status updates.

📄️ List SMS conversations (inbox) for your tenant.

Keyset-paginated, newest-first. Filter by conversation status or by an exact E.164 phone. Scope: read.

📄️ Get a conversation with its 20 most recent messages inline.

Scope: read.

📄️ Update a conversation status (open / closed / archived).

Maps the public value 'open' to the internal 'active' state. 'opted_out' is read-only; it is set by inbound STOP processing and cannot be modified via API. Scope: write_crm.

📄️ Paginated message history for one conversation.

Keyset-paginated, newest-first. Scope: read.

📄️ Send an SMS reply into an existing conversation.

Resolves the recipient phone from the conversation row; no 'to' is required in the body. Respects opt-outs (422). From-number is the tenant dedicated SMS number (tenant_phone_numbers -> tenants.phone fallback). Scope: send_sms.