---
title: "Sending SMS"
method: POST
path: "/v1/messages"
---

# Sending SMS

`POST /v1/messages`

## Request

- Base URL: `https://apis.cequens.com/sms`
- URL: `https://apis.cequens.com/sms/v1/messages`
- Auth: API key in header `Authorization`

Use messages endpoint to send Single or Bulk SMS. When you send SMS messages using this API, the API will return to you the sent messages’ ID to track them later using Cequens Get Message Details by ID API.

## Request body

- object
  - `messageText` string, required: The message content that you want to send.
  - `senderName` string, required: The name of the message sender.
  - `messageType` string, required: Message type either text or unicode Can be text or unicode
  - `recipients` string, required: The intended recipients’ phone numbers.
  - `clientMessageId` integer: An integer used as an identifier for your request to track it.
  - `deliveryTime` string: A string that includes the desired delivery time of the SMS.
  - `dlrUrl` string: A string to define the URL to which you would like to send the delivery receipts (DLR).
  - `dataCoding` string: A string to define the data coding scheme of the SMS.
  - `shortURL` boolean: set it to true, if the messageText contains URL and you want to shorten it

## Response `200`

200

- object
  - `replyCode` integer
  - `replyMessage` string
  - `requestId` string
  - `clientRequestId` integer
  - `requestTime` string
  - `data` object
    - `SentSMSIDs` object[]
      - `SMSId` string
    - `InvalidRecipients` string

## Other responses

- `400`: 400
- `401`: 401

---

[API](https://skmtc.dev/cequens/apis/sms.md) - [All operations](https://skmtc.dev/cequens/apis/sms/llms.txt) - [OpenAPI document](https://skmtc.dev/cequens/apis/sms/revisions/def8ba992ae2?raw)