# Bird Email Contacts API

**Canonical:** https://apis.io/apis/bird/bird-email-contacts-api/  
**Provider:** Bird — https://apis.io/providers/bird/  
**Base URL:** https://api.bird.com  
**Documentation:** https://docs.bird.com/api

Bird Email Contacts API is one of 65 APIs that [Bird](https://apis.io/providers/bird/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. Tagged areas include email-contacts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and an AsyncAPI specification.

Contacts are the people you send broadcasts to. Each contact is unique by email address within a workspace and carries optional name fields and custom properties for personalization. Custom properties are defined once per workspace via the contact properties API and then set per contact.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/contacts` | Create a contact |
| GET | `/v1/contacts` | List contacts |
| POST | `/v1/contacts/batch` | Create or update contacts in bulk |
| GET | `/v1/contacts/{contact_id}` | Get a contact |
| PATCH | `/v1/contacts/{contact_id}` | Update a contact |
| DELETE | `/v1/contacts/{contact_id}` | Delete a contact |
| POST | `/v1/contact-properties` | Create a contact property |
| GET | `/v1/contact-properties` | List contact properties |
| GET | `/v1/contact-properties/{property_id}` | Get a contact property |
| PATCH | `/v1/contact-properties/{property_id}` | Update a contact property |
| POST | `/v1/contact-properties/{property_id}/archive` | Archive a contact property |
| POST | `/v1/contact-properties/{property_id}/unarchive` | Unarchive a contact property |

## Machine-readable artifacts (20)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/bird/refs/heads/main/openapi/bird-email-contacts-api-openapi.yml
- **Documentation** — https://docs.bird.com/api/channels-api/api-reference/messaging
- **Documentation** — https://bird.com/docs
- **APIReference** — https://bird.com/docs/api
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/bird/refs/heads/main/asyncapi/messagebird-bird-webhooks.yml
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/bird/refs/heads/main/mcp/messagebird-tool-crosswalk.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/bird/refs/heads/main/data-model/messagebird-data-model.yml
- **Documentation** — https://developers.messagebird.com/api/sms-messaging/
- **Documentation** — https://developers.messagebird.com/api/voice-calling/
- **Documentation** — https://developers.messagebird.com/api/voice-messaging/
- **Documentation** — https://developers.messagebird.com/api/conversations/
- **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/bird/refs/heads/main/asyncapi/messagebird-conversations-asyncapi.yml
- **Documentation** — https://developers.messagebird.com/api/whatsapp
- **Documentation** — https://developers.messagebird.com/api/verify/
- **Documentation** — https://developers.messagebird.com/api/lookup/
- **Documentation** — https://developers.messagebird.com/api/hlr/
- **Documentation** — https://developers.messagebird.com/api/contacts/
- **Documentation** — https://developers.messagebird.com/api/numbers/
- **Documentation** — https://developers.messagebird.com/api/balance/
- **Documentation** — https://developers.messagebird.com/api/integrations/

## Other Bird APIs (12)

- [Bird Customer Data API](https://apis.io/apis/bird/bird-customer-data-api/)
- [Bird Phone Numbers API](https://apis.io/apis/bird/bird-phone-numbers-api/)
- [Bird Identity Verification API](https://apis.io/apis/bird/bird-identity-verification-api/)
- [Bird Touchpoints API](https://apis.io/apis/bird/bird-touchpoints-api/)
- [Bird Accounts API](https://apis.io/apis/bird/bird-accounts-api/)
- [Bird FAQ API](https://apis.io/apis/bird/bird-faq-api/)
- [Bird Intent API](https://apis.io/apis/bird/bird-intent-api/)
- [Bird SMS Messaging API](https://apis.io/apis/bird/bird-sms-messaging-api/)
- [Bird Channels API](https://apis.io/apis/bird/bird-channels-api/)
- [Bird Contacts API](https://apis.io/apis/bird/bird-contacts-api/)
- [Bird Conversations API](https://apis.io/apis/bird/bird-conversations-api/)
- [Bird Legacy MessageBird API](https://apis.io/apis/bird/bird-legacy-messagebird-api/)

## Tags

email-contacts

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/bird/bird-email-contacts-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/bird/.