Send a policy-gated outbound SMS

Requires sms:send. Message body, provider metadata, error detail and idempotency key are returned only with sms:read, for both fresh sends and idempotent replays.

post/v1/messages

Request

  • Base URL: https://api.skysay.ai
  • URL: https://api.skysay.ai/v1/messages
  • Auth: none declared

Request body

bodystring required
categoriesstring[]
from_phone_number_idstring required
organization_idstring required
project_idstring required
purposestring required

Required, free-form outbound purpose declaration -- a non-empty purpose is the compliance paper trail; a novel purpose token is never refused for being novel. Documented catalog (pick one or send your own token): appointment, booking_confirmation, callback_requested, customer_outreach, delivery_notification, ops_alert, other, payment_reminder, personal_errand, reservation, status_check, support.

recipient_typestring

Optional, never enforced or required -- outbound is not restricted to business recipients. Persisted verbatim on the call row if sent; SMS has no recipient_type column, so it is accepted but not stored there.

to_phone_numberstring required
user_authorizationobject

Response

Message

Changes

No recorded changes to this operation across all 1 revision of this API.