---
title: "bird amb business-accounts create"
description: "Create an Apple Messages for Business record"
canonical: "https://bird.com/docs/cli/reference/amb-business-accounts-create"
---

# `bird amb business-accounts create`

## Usage

```bash
bird amb business-accounts create [flags]
```

## Description

Create an Apple Messages for Business record

Creates a draft business in your workspace. Supplying Apple's business UUID does not submit the record; upload evidence and create a submission when ready for review.

Build the request from flags, a JSON AMBBusinessAccountCreate body via --body-file ("-" reads
stdin), or both — a flag overrides the matching body field. Run --example to
print a ready-to-edit body, or --dry-run to print the resolved request without
sending it.

## Examples

```bash
# print the body shape (no credentials needed)
bird amb business-accounts create --example

# the body it prints:
```

```json
{
  "name": "Acme Retail"
}
```

## Options

#### Request

| Name                | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| `--body-file`       | Read the JSON request body from this file; "-" reads stdin   |
| `--example`         | Print a complete example request body, then exit             |
| `--dry-run`         | Print the resolved request without sending it, then exit     |
| `--idempotency-key` | Deduplication key; a retry with the same key won't act twice |

#### Options

| Name                  | Description                                                                                                                                                                                          |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--name`              | The brand name shown for this business record inside Bird. (required; or in --body-file)                                                                                                             |
| `--apple-business-id` | The Business ID Apple issued for this brand, if you already have it. Supplying it identifies the draft. Submit the completed evidence requirements explicitly when the business is ready for review. |
| `--response-schema`   | Print the fields this command returns, then exit                                                                                                                                                     |

## Related

| Name                                                                                          | Description                                  |
| --------------------------------------------------------------------------------------------- | -------------------------------------------- |
| [`bird amb business-accounts delete`](/docs/cli/reference/amb-business-accounts-delete)       | Disconnect an Apple business account         |
| [`bird amb business-accounts get`](/docs/cli/reference/amb-business-accounts-get)             | Get an Apple Messages for Business record    |
| [`bird amb business-accounts list`](/docs/cli/reference/amb-business-accounts-list)           | List Apple Messages for Business records     |
| [`bird amb business-accounts reconnect`](/docs/cli/reference/amb-business-accounts-reconnect) | Reconnect an Apple business account          |
| [`bird amb business-accounts update`](/docs/cli/reference/amb-business-accounts-update)       | Update an Apple Messages for Business record |

## 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)