---
title: "Send Sms Message"
method: POST
path: "/v2/sms/messages/{sms_id}/send"
tags: ["sms"]
---

# Send Sms Message

`POST /v2/sms/messages/{sms_id}/send`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/sms/messages/{sms_id}/send`
- Auth: HTTP bearer

Send SMS

Send a draft SMS message via Twilio. The SMS must be in DRAFT status.

## Path parameters

- `sms_id` string, required

## Response `200`

Successful Response

- SMS: An SMS message.
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, nullable, required
  - `id` string, required
  - `body` string, required: The message content
  - `classifications` InteractionClassification[], required
    - `created_at` string, date-time, required
    - `modified_at` string, date-time, nullable, required
    - `id` string, required
    - `action_recommendation` string, nullable, required: Necessary actions that need to be taken in response to this interaction
    - `agent_confidence_score` integer, nullable, required: The confidence score of the result on a scale of 0-100, where 0 indicates no confidence in the accuracy of the result and 100 indicates full confidence in the accuracy of the result.
    - `agent_metrics` AgentMetrics, required: The AI agent's confidence metrics
      - `confidence_reason` string, nullable: The justification for the agent's confidence score.
      - `confidence_score` integer, nullable: The confidence score of the result on a scale of 0-100, where 0 indicates no confidence in the accuracy of the result and 100 indicates full confidence in the accuracy of the result.
      - `error_code` 'duplicate' | 'insufficient' | 'invalid_file_type' | 'irrelevant' | 'processing_error' | 'upload_missing', nullable: The code for why an error occurred when processing the statement.
      - `uncertainties` string[]: A list of uncertainties we have regarding the result.
    - `classification` 'payment_inquiry' | 'payment_promise' | 'account_inquiry' | 'invoice_inquiry' | 'refund_request' | 'cancellation_request' | 'support_request' | 'complaint' | 'feedback' | 'wrong_contact' | 'message_forwarding_request' | 'cc_inclusion_request' | 'not_available' | 'contact_inquiry' | 'dispute' | 'resolution' | 'delivery_failure' | 'payment_processing_request' | 'other', required: Enumerates the possible classifications for an interaction (email or call).
    - `evidence` object, nullable, required: The text excerpts that led to the classification decision
    - `is_action_required` boolean, required: Whether an action or actions need to be taken as a result of this interaction
    - `is_reply_required` boolean, required: Whether an email needs to be sent as a reply to this interaction
    - `language` string, nullable, required: The detected language of the interaction using ISO 639-1 alpha-2 code.
    - `reason` string, required: The reason for the classifications of the interaction
    - `object` string, required: String representing the object's type. Objects of the same type share the same value.
  - `direction` 'inbound' | 'outbound', required
  - `from_number` string, phone, required: The sending phone number
  - `to_number` string, phone, required: The receiving phone number
  - `status` 'draft' | 'pending' | 'sent' | 'delivered' | 'failed' | 'undelivered', required
  - `is_automated` boolean, required: Whether the SMS was automatically sent by a workflow
  - `sent_at` string, date-time, nullable, required
  - `delivered_at` string, date-time, nullable, required
  - `error_message` string, nullable, required: Twilio error message if delivery failed
  - `object` string, required: String representing the object's type. Objects of the same type share the same value.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stuut/apis/stuut-api.md) - [All operations](https://skmtc.dev/stuut/apis/stuut-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stuut/apis/stuut-api/revisions/ff0ad16a55ff?raw)