# Bird Preferences API

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

Bird Preferences 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 Preferences. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and an AsyncAPI specification.

Stated messaging preferences (consent grants and opt-outs) recorded per handle across email, SMS, and WhatsApp, with causally ordered writes.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/contacts/{contact_id}/preferences` | List a contact's preferences |
| GET | `/v1/preferences` | List preferences |
| POST | `/v1/preferences` | Record a preference |
| GET | `/v1/preferences/{preference_id}` | Get a preference |
| DELETE | `/v1/preferences/{preference_id}` | Delete a preference |

## Machine-readable artifacts (20)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/bird/refs/heads/main/openapi/bird-preferences-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

Preferences

---

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