> For the complete documentation index, see [llms.txt](https://docs.bird.com/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bird.com/api/contacts-api/api-reference.md).

# API reference

- [Manage workspace contacts](https://docs.bird.com/api/contacts-api/api-reference/manage-workspace-contacts.md): The following endpoints allow for creating contacts and managing their life cycle.
- [Create a contact](https://docs.bird.com/api/contacts-api/api-reference/manage-workspace-contacts/create-a-contact.md)
- [Get a contact](https://docs.bird.com/api/contacts-api/api-reference/manage-workspace-contacts/get-a-contact.md)
- [List contacts](https://docs.bird.com/api/contacts-api/api-reference/manage-workspace-contacts/list-contacts.md)
- [Search contact by identifier](https://docs.bird.com/api/contacts-api/api-reference/manage-workspace-contacts/search-contact-by-identifier.md)
- [Update a contact](https://docs.bird.com/api/contacts-api/api-reference/manage-workspace-contacts/update-a-contact.md)
- [Create or update a contact by identifier](https://docs.bird.com/api/contacts-api/api-reference/manage-workspace-contacts/create-or-update-a-contact-by-identifier.md)
- [Delete a contact](https://docs.bird.com/api/contacts-api/api-reference/manage-workspace-contacts/delete-a-contact.md)
- [Manage contact identifiers](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-identifiers.md): The following endpoints allow for managing the identifiers for a single contact.
- [Create contact identifier](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-identifiers/create-contact-identifier.md)
- [List contact identifiers](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-identifiers/list-contact-identifiers.md)
- [Delete contact identifier](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-identifiers/delete-contact-identifier.md)
- [Manage contact attribute definition](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-attribute-definition.md): The following endpoints allow for managing the custom attribute schema for your contacts.
- [Create attribute definition](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-attribute-definition/create-attribute-definition.md)
- [Get attribute definition](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-attribute-definition/get-attribute-definition.md)
- [List attribute definitions](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-attribute-definition/list-attribute-definitions.md)
- [Manage contact lists](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists.md): The following endpoints allow for creating contact lists and managing their life cycle.
- [Create a list](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/create-a-list.md)
- [Get a list](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/get-a-list.md)
- [List lists](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/list-lists.md)
- [Update a list](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/update-a-list.md)
- [Delete a list](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/delete-a-list.md)
- [Add contacts to a list](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/add-contacts-to-a-list.md)
- [Trigger double opt-in confirmations for a list](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/trigger-double-opt-in.md)
- [Get contact list memberships](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/get-contact-list-memberships.md)
- [List contacts in a list](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/list-contacts-in-a-list.md)
- [Remove contacts from a list](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-lists/remove-contacts-from-a-list.md)
- [Manage contact suppressions](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-suppressions.md): The following endpoints allow for managing suppressions for a single identifier value.
- [Upsert a workspace-platform-level suppression](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-suppressions/upsert-a-workspace-platform-level-suppression.md)
- [Get a suppression](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-suppressions/get-a-suppression.md)
- [List workspace-platform-level suppressions](https://docs.bird.com/api/contacts-api/api-reference/manage-contact-suppressions/list-workspace-platform-level-suppressions.md)
- [Manage custom objects](https://docs.bird.com/api/contacts-api/api-reference/manage-custom-objects.md)