Sign in
conversations

Send Message

Send a message in a conversation.

This endpoint:

  1. Validates request
  2. Sends SMS/MMS via Twilio
  3. Saves message to database
  4. Triggers side effects (intent tracking, activity logging, summary generation)

Either body or media_urls (or both) must be provided.

post/conversations/{conversation_id}/send

Path parameters

conversation_idstring uuid required

Request body

bodystring nullable
media_urlsstring[] nullable
local_datestring nullable

User's local date in YYYY-MM-DD format for tracking attempts

sourcestring nullable

Source of the request: 'mobile' or 'dashboard'

target_phonestring nullable

Specific phone number to send to (for multi-phone support). If not provided, uses primary phone.

Response

Successful Response

idstring uuid required
conversation_idstring uuid required
followup_idstring uuid nullable required
directionstring required
from_numberstring required
to_numberstring required
bodystring nullable required
media_urlsobject[] nullable required
media_summaryobject[] nullable
media_summary_generated_atstring date-time nullable
twilio_message_sidstring nullable required
is_readboolean required
created_atstring date-time required
user_idstring uuid nullable
sender_namestring nullable
provider_message_statusstring nullable
provider_error_codeinteger nullable
provider_error_messagestring nullable
reactionsobject[] nullable

Changes