---
title: "Give this brand its own SMS sending number"
method: POST
path: "/v1/brands/{id}/sms-number"
tags: ["Google & carriers"]
---

# Give this brand its own SMS sending number

`POST /v1/brands/{id}/sms-number`

## Request

- Base URL: `https://api.cadencercs.com`
- URL: `https://api.cadencercs.com/v1/brands/{id}/sms-number`
- Auth: HTTP bearer

Buys a local SMS-capable number, adds it to the registered messaging campaign, and stores it on the brand. From then on this brand's SMS (fallback included) goes out from that number and replies to it are routed to this brand. Idempotent: a brand that already has one keeps it and nothing is bought. Live keys only — sandbox brands never reach a carrier. Roughly $1.15/month per number, billed as part of your plan.

## Path parameters

- `id` string, required

## Request body

- object
  - `areaCode` string: Three digits, e.g. `206`. Optional; omit for any US number.

## Response `200`

The brand's number.

- object
  - `brandId` string, required
  - `e164` string, required
  - `provisioned` boolean, required: True when a number was bought on this call.
  - `note` string

## Other responses

- `400`: `areaCode` is not three digits.
- `401`: Not signed in, and no account-linked API key was sent.
- `403`: Sandbox key.
- `404`: No such brand on this account.
- `409`: No number available, in that area code or at all.
- `500`: Unexpected server error. The body is always JSON.
- `502`: The SMS provider refused.

---

[API](https://skmtc.dev/cadencercs/apis/cadence-api.md) · [All operations](https://skmtc.dev/cadencercs/apis/cadence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cadencercs/apis/cadence-api/revisions/9438443c2081?raw)