SMS

Base path: https://api.recepta.ai/api/v1/api/sms All endpoints require an API key in x-api-key, and the permission noted on each.

US SMS requires approved A2P 10DLC registration. Without it, carriers filter or block your messages regardless of what the API returns.

Send a message

sms:send

required

string

required

Recipient number. E.164 recommended — +14155551234.

string

required

One of your own provisioned numbers. Sending from a number that isn’t yours returns 403.

string

required

Message content.

curl -X POST https://api.recepta.ai/api/v1/api/sms/send \
  -H "x-api-key: $RECEPTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155551234",
    "from": "+14155559876",
    "body": "Hi Dana, it'\''s Dan from Coral Plumbing - confirming Thursday 8-10am."
  }'

Returns 201 on success, 400 if a required field is missing, 403 if from isn’t one of your numbers.

You must have consent to text the recipient, and opt-outs are enforced — a suppressed number will not receive messages sent through this endpoint. Don’t build around that. See SMS.

List conversations

sms:read

required

Query param	Type	Default	Notes
`page`	integer	`1`	Page number
`limit`	integer	`50`	Items per page
`search`	string	—	Matches phone number or customer name
`status`	enum	—	`ACTIVE`, `ARCHIVED`, `CLOSED`

curl "https://api.recepta.ai/api/v1/api/sms?status=ACTIVE&limit=25" \
  -H "x-api-key: $RECEPTA_API_KEY"

List messages in a conversation

sms:read

required

Query param	Type	Default
`page`	integer	`1`
`limit`	integer	`50`

curl "https://api.recepta.ai/api/v1/api/sms/CONVERSATION_ID/messages" \
  -H "x-api-key: $RECEPTA_API_KEY"

Returns 404 if the conversation isn’t in your workspace.

Writing messages that arrive

Identify yourself first

Name the person and your business in the opening line. An unidentified text from an unknown number reads as spam and gets reported as such.

Mind the clock

Send within reasonable local hours for the recipient. Your server’s timezone is not a defense.

Receiving messages

Subscribe to sms.received and sms.sent to handle inbound texts in your own systems as they arrive, rather than polling. See Webhooks.

Overview

Endpoints

Automation

Send a message

List conversations

List messages in a conversation

Writing messages that arrive

Identify yourself first

Mind the clock

Receiving messages

​Send a message

​List conversations

​List messages in a conversation

​Writing messages that arrive

Identify yourself first

Mind the clock

​Receiving messages

Send a message

List conversations

List messages in a conversation

Writing messages that arrive

Receiving messages