---
title: "Creates an SMS campaign"
method: POST
path: "/smsCampaigns"
tags: ["SMS Campaigns"]
---

# Creates an SMS campaign

`POST /smsCampaigns`

## Request body

- CreateSmsCampaign
  - `name` string, required — Name of the campaign
  - `sender` string, required — Name of the sender. **The number of characters is limited to 11 for alphanumeric characters and 15 for numeric characters**
  - `content` string, required — Content of the message. The maximum characters used per SMS is 160, if used more than that, it will be counted as more than one SMS
  - `recipients` CreateSmsCampaignRecipients
    - `listIds` integer[], required — Lists Ids to send the campaign to. REQUIRED if scheduledAt is not empty
    - `exclusionListIds` integer[] — List ids which have to be excluded from a campaign
  - `scheduledAt` string — UTC date-time on which the campaign has to run (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result.
  - `unicodeEnabled` boolean — Format of the message. It indicates whether the content should be treated as unicode or not.
  - `organisationPrefix` string — A recognizable prefix will ensure your audience knows who you are. Recommended by U.S. carriers. This will be added as your Brand Name before the message content. **Prefer verifying maximum length of 160 characters including this prefix in message content to avoid multiple sending of same sms.**
  - `unsubscribeInstruction` string — Instructions to unsubscribe from future communications. Recommended by U.S. carriers. Must include **STOP** keyword. This will be added as instructions after the end of message content. **Prefer verifying maximum length of 160 characters including this instructions in message content to avoid multiple sending of same sms.**

## Response `201`

SMS campaign created

- CreateModel
  - `id` integer, required — ID of the object created

## Other responses

- `400` — bad request

---

[API](https://skmtc.net/getbrevo/apis/brevo-api.md) · [All operations](https://skmtc.net/getbrevo/apis/brevo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbrevo/brevo-api/versions/2aec3cf66501/schema)
