---
title: "Send SMS using a Pool"
method: POST
path: "/pools/my/{poolId}/sms"
---

# Send SMS using a Pool

`POST /pools/my/{poolId}/sms`

Sends a single SMS using a pool

## Path parameters

- `poolId` string, required

## Headers

- `Content-Type` string, required
- `Authorization` string, required

## Request body

- object
  - `to` string, required — The recipient of the SMS. Format with a '+' and country code e.g., +3069485xxxxx (E.164 format).
  - `poolStrategy` string, required — The strategy to follow when picking a sender from the pool. Values: Numeric, Alphanumeric
  - `body` string, required — The body of the SMS message.
  - `urlShortener` object — [OPTIONAL] If present, each link that exist in message body will be replaced by a Shortened URL. NOTE: Links are recognized by the prefix "http://" or "https://" and are separated by the next word or character with space. Keep in mind that adding any character like '.' ',' etc, other than space at the end of the link, will be recognized as part of the url and it will result to a shortened url that redirects to a wrong destination.
    - `urlValidity` string — [Optional]. Possible values: 3600 up to 2592000. Indicates the time in seconds that the shorten url will be valid (min: 3600 [one hour] - max: 2592000 [30 days]). Default value 2592000
    - `callbackURL` string — The endpoint Routee will use to POST the visit payload from the Shortener Microservice.

## Response `200`

200

- object
  - `trackingId` string
  - `status` string
  - `createdAt` string
  - `poolId` string
  - `poolName` string
  - `poolStrategy` string
  - `smsSettings` object
    - `sticky` boolean
    - `geomatch` boolean
    - `transcode` boolean
    - `alphanumericSenderId` string
  - `to` string
  - `from` string
  - `body` string
  - `bodyAnalysis` object
    - `parts` integer
    - `unicode` boolean
    - `characters` integer
  - `urlShortener` object
    - `urlValidity` integer
    - `urls` object[]
      - `longUrl` string
      - `shortUrl` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/routee/apis/auth.md) · [All operations](https://skmtc.net/routee/apis/auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/routee/auth/versions/5cef04e8f7d8/schema)
