Skip to main content
POST
Text a contact from the user's phone

Authorizations

Authorization
string
header
required

OAuth 2.1 access token issued by Reflecto's authorization server to a connected AI assistant (the remote MCP connector flow). Must carry the sms:send scope, which is never granted to rfk_live_ API tokens.

Body

application/json
contact_handle
string
required

A handle from POST /v1/sms-agent/contact-queries. There is no way to send to a raw phone number.

Example:

"ch_q3V9xK2mP0aL7bN4cR1sTw"

body
string
required

The message text. 1–1600 characters.

Example:

"Running 15 minutes late for dinner"

Response

The send's state when this call returned.

state
enum<string>
required

sent = the phone handed the SMS to the network. failed carries a reason. pending = not confirmed within 30 s; the send is neither retried nor cancelled, and calling again with the same handle returns the current state without sending again.

Available options:
sent,
failed,
pending
Example:

"sent"

reason
enum<string>

Present only when state is failed.

Available options:
disabled,
rate_limited,
handle_expired,
no_sms_permission,
no_service,
send_error,
phone_unreachable
Example:

"handle_expired"

recipient_label
string

Name · Label of the recipient, as the lookup returned it — when the phone reported it while this request was waiting. Never a number.

Example:

"Richa Sharma · Mobile"