---
title: "SMS docs"
description: "Senders, consent, and every SMS API call."
url: https://www.unitpost.com/docs/sms
section: "SMS docs"
updated: 2026-10-10
---

# SMS docs

> Senders, consent, and every SMS API call.

HTML hub: https://www.unitpost.com/docs/sms

- [SMS API quickstart](https://www.unitpost.com/docs/sms/start): A brand, a sender, consent, then the first text. ([Markdown](https://www.unitpost.com/docs/sms/start.md))
- [Get a contact's SMS consent (`GET /contacts/{id}/sms-consent`)](https://www.unitpost.com/docs/sms/get-contacts-id-sms-consent): Read a contact's current SMS consent state and the full immutable consent history — what was agreed to, when, and from which source. `GET /api/v1/contacts/{id}/sms-consent` ([Markdown](https://www.unitpost.com/docs/sms/get-contacts-id-sms-consent.md))
- [Record SMS consent (`POST /contacts/{id}/sms-consent`)](https://www.unitpost.com/docs/sms/post-contacts-id-sms-consent): Record an SMS opt-in or opt-out that a recipient gave you — typically a checkbox on your own signup form. `POST /api/v1/contacts/{id}/sms-consent` ([Markdown](https://www.unitpost.com/docs/sms/post-contacts-id-sms-consent.md))
- [List SMS messages (`GET /sms`)](https://www.unitpost.com/docs/sms/get-sms): Retrieve your workspace's SMS messages (outbound and inbound), newest-first and cursor-paginated. `GET /api/v1/sms` ([Markdown](https://www.unitpost.com/docs/sms/get-sms.md))
- [Send an SMS message (`POST /sms`)](https://www.unitpost.com/docs/sms/post-sms): Send a single SMS — now, or at a future time by passing scheduled_at. `POST /api/v1/sms` ([Markdown](https://www.unitpost.com/docs/sms/post-sms.md))
- [List SMS brands (`GET /sms/brands`)](https://www.unitpost.com/docs/sms/get-sms-brands): Retrieve your SMS brands and their setup status. `GET /api/v1/sms/brands` ([Markdown](https://www.unitpost.com/docs/sms/get-sms-brands.md))
- [List SMS phone numbers (`GET /sms/numbers`)](https://www.unitpost.com/docs/sms/get-sms-numbers): Retrieve your SMS sending identities: phone numbers and alphanumeric Sender IDs. `GET /api/v1/sms/numbers` ([Markdown](https://www.unitpost.com/docs/sms/get-sms-numbers.md))
- [Retrieve an SMS message (`GET /sms/{id}`)](https://www.unitpost.com/docs/sms/get-sms-id): Retrieve one SMS message's current status, delivery state, and segment count by id. `GET /api/v1/sms/{id}` ([Markdown](https://www.unitpost.com/docs/sms/get-sms-id.md))