# 📇 Contact

Manage contact information and relationships for clients.

 - [POST /gql/v1/contacts](https://dev.docs.api.aiwyn.ai/api/bundle/contact/getcontactspaginated.md): **Retrieve all contacts with basic pagination support** **Pagination (v1 — limit/offset):** `pageSize` is a limit (records to return). `page` is an offset (records to skip), not a page index. Hasura m
 - [POST /gql/v1/contacts/search](https://dev.docs.api.aiwyn.ai/api/bundle/contact/filtercontactsdynamic.md): **Advanced contact filtering with custom GraphQL where clauses and dynamic ordering** **Pagination (v1 — limit/offset):** `pageSize` is a limit (records to return). `page` is an offset (records to ski
 - [GET /gql/v1/contact/{id}](https://dev.docs.api.aiwyn.ai/api/bundle/contact/getcontactbyid.md): **Retrieve a specific contact by its unique identifier** This endpoint provides detailed contact information including: - Complete contact details and demographics - Contact status and relationship in
 - [GET /gql/v1/contacts/by_client/{clientId}](https://dev.docs.api.aiwyn.ai/api/bundle/contact/getcontactsbyclientid.md): **Retrieve active contacts associated with a specific client** Returns all contacts linked to the given client via the contact-client relationship, where the contact, contact-client link, and contact
 - [POST /api/v1/contacts/upsert](https://dev.docs.api.aiwyn.ai/api/bundle/contact/upsertcontact.md): **Upsert up to 100 contacts, each linked to one or more existing clients, in one request** Send a `contacts` array (1–100). Each entry upserts a contact (contact_info + contact) and its links to exist