# `bird contacts`

## Usage

```bash
bird contacts
```

## Description

Manage the contacts in your workspace: the people you send messages to.
Contacts are unique by email address, and carry custom values keyed by the
properties you define with the contact-properties command group.

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. Destructive commands require --yes.

## Commands

| Name                                            | Description                                                      |
| ----------------------------------------------- | ---------------------------------------------------------------- |
| [`batch`](/docs/cli/reference/contacts-batch)   | Create or update many contacts in one request, matched by email. |
| [`create`](/docs/cli/reference/contacts-create) | Create a contact by email address.                               |
| [`delete`](/docs/cli/reference/contacts-delete) | Delete a contact                                                 |
| [`get`](/docs/cli/reference/contacts-get)       | Get a contact                                                    |
| [`list`](/docs/cli/reference/contacts-list)     | List contacts                                                    |
| [`update`](/docs/cli/reference/contacts-update) | Update a contact's name, email, external-id, or custom data.     |