# `bird amb`

## Usage

```bash
bird amb
```

## Description

Sends use an approved Apple business ID and the conversation’s opaque customer ID. JSON reads are paginated; mutations accept flags or --body-file.

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.

## Procedure

**Reply to an Apple Messages conversation**

Reply as an approved business to a conversation the customer opened. Acceptance queues the message; sent means Apple's gateway accepted it, not device delivery or a read receipt.

Requires: The sender must be an approved business in the authenticated workspace. Use its apple\_business\_id as from, not its Bird record ID.

Requires: The customer must have opened a conversation with that business. Use the conversation's opaque\_user\_id as to, not a phone number. The conversation must be open and the recipient unsuppressed.

Requires: Review the exact business, recipient and content before sending. Reuse the same idempotency key when retrying the same request.

1. `bird amb send` — Queues the reply and returns its message ID. Next: bird amb get or bird amb list-events

## Commands

| Name                                                     | Description                                        |
| -------------------------------------------------------- | -------------------------------------------------- |
| [`businesses`](/docs/cli/reference/amb-businesses)       | Manage your workspace’s Apple business records     |
| [`conversations`](/docs/cli/reference/amb-conversations) | Read and manage customer-initiated conversations   |
| [`get`](/docs/cli/reference/amb-get)                     | Get a message                                      |
| [`list`](/docs/cli/reference/amb-list)                   | List messages                                      |
| [`list-events`](/docs/cli/reference/amb-list-events)     | List events for a message                          |
| [`routing-rules`](/docs/cli/reference/amb-routing-rules) | Route incoming Apple conversations to queue labels |
| [`send`](/docs/cli/reference/amb-send)                   | Reply to an Apple Messages conversation            |
| [`stats`](/docs/cli/reference/amb-stats)                 | Inspect Apple gateway acceptance and failures      |
| [`suppressions`](/docs/cli/reference/amb-suppressions)   | Block messages to Apple customer identifiers       |

## Related resources

- [Should I use a Bird SDK or call the API directly?](/explained/platform/should-i-use-an-sdk-or-call-the-api-directly) (answer)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=api-basics)