> ## Documentation Index
> Fetch the complete documentation index at: https://docs.receptonic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Send SMS

> Send an SMS message using your phone number

This endpoint allows you to send SMS messages using your purchased phone numbers. The SMS will be sent via Twilio and costs will be automatically deducted from your account balance.

### Request Body

**from** `integer` *required*

The ID of your phone number to send the SMS from (must be SMS-capable)

**to** `string` *required*

The recipient's phone number in international format (e.g., "+1234567890")

**body** `string` *required*

The SMS message content (max 300 characters)

### Response

**message** `string`

Success message confirming SMS was sent

**data** `object`

**properties**

**id** `integer`

The unique identifier of the SMS record

**phone\_number\_id** `integer`

The ID of the phone number used to send the SMS

**to** `string`

The recipient's phone number in E.164 format

**body** `string`

The SMS message content

**user\_id** `integer`

The ID of the user who sent the SMS

**segments** `integer`

Number of SMS segments (for billing purposes)

**segment\_price** `number`

Cost per SMS segment

**total\_cost** `number`

Total cost of the SMS (segment\_price \* segments)

**status** `string`

The current status of the SMS

**sms\_sid** `string`

Twilio SMS SID for tracking

**created\_at** `string`

The date and time when the SMS was created

**updated\_at** `string`

The date and time when the SMS was last updated

### Error Responses

**400 Bad Request**

**Error Response**

**message** `string`

Error message describing the issue (invalid phone number, insufficient balance, etc.)

**500 Internal Server Error**

**Error Response**

**message** `string`

Error message indicating SMS sending failure

**error** `string`

Detailed error information

```json 201 Success Response theme={null}
{
  "message": "SMS sent successfully",
  "data": {
    "id": 456,
    "phone_number_id": 78,
    "to": "+1234567890",
    "body": "Hello! This is a test message from Your Company. How can we help you today?",
    "user_id": 1,
    "segments": 1,
    "segment_price": 0.0075,
    "total_cost": 0.0075,
    "status": "sent",
    "sms_sid": "SM1234567890abcdef1234567890abcdef",
    "created_at": "2025-08-04 15:30:00",
    "updated_at": "2025-08-04 15:30:02"
  }
}
```

```json 400 Bad Request theme={null}
{
  "message": "From number not found"
}
```

```json 400 Bad Request theme={null}
{
  "message": "Invalid to phone number"
}
```

```json 400 Bad Request theme={null}
{
  "message": "Insufficient balance"
}
```

```json 400 Bad Request theme={null}
{
  "message": "From number is not SMS capable"
}
```

```json 500 Internal Server Error theme={null}
{
  "message": "Failed to send SMS",
  "error": "Twilio API error details"
}
```

### Notes

* The sender phone number must belong to the authenticated user
* The sender phone number must be SMS-capable
* The phone number subscription must be active (not expired)
* Sufficient account balance is required to cover SMS costs
* Phone numbers are automatically formatted to E.164 format
* SMS costs vary by destination country and are charged per segment
* Long messages may be split into multiple segments, increasing the cost
* The recipient phone number must be valid according to international standards


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.