---
title: "Send an SMS message"
method: POST
path: "/messages/send"
tags: ["Messages"]
---

# Send an SMS message

`POST /messages/send`

Add a new SMS message to be sent by your Android phone

## Request body

- RequestsMessageSend
  - `attachments` string[] — Attachments are optional. When you provide a list of attachments, the message will be sent out as an MMS
  - `content` string, required
  - `encrypted` boolean — Encrypted is an optional parameter used to determine if the content is end-to-end encrypted. Make sure to set the encryption key on the httpSMS mobile app
  - `from` string, required
  - `request_id` string — RequestID is an optional parameter used to track a request from the client's perspective
  - `send_at` string — SendAt is an optional parameter used to schedule a message to be sent in the future. The time is considered to be in your profile's local timezone and you can queue messages for up to 20 days (480 hours) in the future.
  - `to` string, required

## Response `200`

OK

- ResponsesMessageResponse
  - `data` EntitiesMessage, required
    - `attachments` string[], required
    - `contact` string, required
    - `content` string, required
    - `created_at` string, required
    - `delivered_at` string
    - `encrypted` boolean, required
    - `expired_at` string
    - `failed_at` string
    - `failure_reason` string
    - `id` string, required
    - `last_attempted_at` string
    - `max_send_attempts` integer, required
    - `order_timestamp` string, required
    - `owner` string, required
    - `received_at` string
    - `request_id` string
    - `request_received_at` string, required
    - `scheduled_at` string
    - `scheduled_send_time` string
    - `send_attempt_count` integer, required
    - `send_time` integer — SendDuration is the number of nanoseconds from when the request was received until when the mobile phone send the message
    - `sent_at` string
    - `sim` 'SIM1' | 'SIM2', required
    - `status` string, required
    - `type` string, required
    - `updated_at` string, required
    - `user_id` string, required
  - `message` string, required
  - `status` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/ndolestudio/apis/httpsms-api-reference.md) · [All operations](https://skmtc.net/ndolestudio/apis/httpsms-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ndolestudio/httpsms-api-reference/versions/ddd090b6b679/schema)