Skip to main content
POST
Look up a saved contact to text, by name

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
query
string
required

The contact's name as the user said it, including a number type (Mobile/Work/Home) if they said one. Never a phone number: a query that is mostly digits is refused.

Example:

"Richa mobile"

Response

The phone's answer, or phone_unreachable if it did not answer within 15 s. Every outcome is a 200 — only ok carries candidates.

status
enum<string>
required

ok carries 1–5 candidates. no_match / too_many (more than 5 — ask for a more specific name) carry none. disabled = the user has not switched on “Let assistants send texts” on the phone. phone_unreachable = the phone did not answer within 15 s. The remaining values are phone-side refusals: too_many_lookups (30/hour), no_contacts_permission, no_sms_permission, invalid_query, contacts_unavailable.

Available options:
ok,
no_match,
too_many,
disabled,
too_many_lookups,
no_contacts_permission,
no_sms_permission,
invalid_query,
contacts_unavailable,
phone_unreachable
Example:

"ok"

candidates
object[]

Present only when status is ok. Never contains a phone number.