# `bird sms`

## Usage

```bash
bird sms
```

## Description

Send SMS messages and read them back. Send free text with --text (and --category),
or a stored template with --template.

Reads return JSON; list is paginated. Mutations take flags and/or a --body-file JSON body (flags overriding); run --example to print the body shape or --dry-run to preview the request.

## Messages

| Name                                   | Description                           |
| -------------------------------------- | ------------------------------------- |
| [`send`](/docs/cli/reference/sms-send) | Send an SMS message to one recipient. |
| [`get`](/docs/cli/reference/sms-get)   | Get an SMS message                    |
| [`list`](/docs/cli/reference/sms-list) | List SMS messages                     |

## Templates

| Name                                             | Description                          |
| ------------------------------------------------ | ------------------------------------ |
| [`templates`](/docs/cli/reference/sms-templates) | Browse the workspace's SMS templates |