# `bird amb businesses create`

## Usage

```bash
bird amb businesses 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 in the dashboard and create a submission when ready for review.

Build the request from flags, a JSON AMBBusinessCreate 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 businesses create --example

# the body it prints:
```

```json
{
  "display_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                                                                                                                                                                                          |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--display-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 businesses get`](/docs/cli/reference/amb-businesses-get)       | Get an Apple Messages for Business record    |
| [`bird amb businesses list`](/docs/cli/reference/amb-businesses-list)     | List Apple Messages for Business records     |
| [`bird amb businesses update`](/docs/cli/reference/amb-businesses-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)