# Contacts API

Bird's Contacts API offers a powerful solution for managing customer contact information. You can create and maintain a comprehensive directory by defining individual contact records for each customer, with support for multiple contact identifiers such as email addresses and phone numbers. The API also allows you to configure custom schemas for storing additional customer attributes, enabling tailored data management to fit your business needs. Additionally, the Contacts API integrates seamlessly with Bird's Channels and Conversations APIs, ensuring that your contact data is ready for use in communication workflows and customer interactions.

## API Access, Authorizations and Usage <a href="#api-access-authorizations-and-usage" id="api-access-authorizations-and-usage"></a>

For detailed instructions on obtaining access, please refer to the [API Access section](/api/api-access.md). There, you'll find guidance on acquiring access tokens and the base URL required for subsequent requests. If you already finished setting your access, please refer to subsection [Common API usage](/api/api-access/common-api-usage.md) to understand how to send requests to Bird and how to work with our responses.

To learn more about Contacts API, please refer to the API Reference linked below.

{% content-ref url="/pages/rs6zXGJXkl5aZYwc6SXb" %}
[API reference](/api/contacts-api/api-reference.md)
{% endcontent-ref %}

To learn more about tracking contact events, please refer to the Page linked below.

{% content-ref url="/pages/V24k9gUEI8sWySllFexJ" %}
[Tracking Contact Events](/api/contacts-api/tracking-contact-events.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bird.com/api/contacts-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.