# Customer Contacts

## Filter customer contacts

 - [POST /customer-contacts/filter](https://docs.mvmnt.io/apis/openapi/customer-contacts/filtercustomercontacts.md): Query customer contacts using flexible filter criteria with AND/OR logic.

By default, only non-deleted customer contacts are returned (deletedAt: { isNull: true }).
Override this by explicitly setting deletedAt filter criteria.

## Create customer contact

 - [POST /customer-contacts](https://docs.mvmnt.io/apis/openapi/customer-contacts/createcustomercontact.md): Create a new customer contact. The contactInfo will create a new Contact record,
and the CustomerContact will reference it via parentContactId (managed internally).

## Get customer contact

 - [GET /customer-contacts/{id}](https://docs.mvmnt.io/apis/openapi/customer-contacts/getcustomercontactbyid.md): Retrieve a single customer contact by its unique identifier

## Update customer contact

 - [PATCH /customer-contacts/{id}](https://docs.mvmnt.io/apis/openapi/customer-contacts/updatecustomercontact.md): Partially update a customer contact. Only provided fields will be updated.

- Omitted fields: Not modified (current value preserved)
- Provided fields: Updated to the new value
- Null values: Clear the field (set to null) where applicable

When updating contactInfo, the underlying Contact record is updated.

## Delete customer contact

 - [DELETE /customer-contacts/{id}](https://docs.mvmnt.io/apis/openapi/customer-contacts/deletecustomercontact.md): Soft delete a customer contact (sets deletedAt timestamp).

The contact will no longer appear in default queries but can be retrieved
by explicitly filtering for deleted records.