# Carrier Contacts

## Filter carrier contacts

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

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

## Create carrier contact

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

## Get carrier contact

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

## Update carrier contact

 - [PATCH /carrier-contacts/{id}](https://docs.mvmnt.io/apis/openapi/carrier-contacts/updatecarriercontact.md): Partially update a carrier 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 carrier contact

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

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