---
title: "Create an alert mute"
method: POST
path: "/v3/alerts/mutes"
tags: ["Alerts & Risks"]
---

# Create an alert mute

`POST /v3/alerts/mutes`

Creates an alert mute for the current client account. CUSTOMER entity identifiers must be valid UUIDs; COUNTERPARTY identifiers are accepted as strings.


You need the "Create and delete mutes" permission to use this endpoint.

## Request body

- AmCreateAlertMuteV3Request
  - `entity` AmAlertMuteEntityRequest, required — Entity scope for the mute. CUSTOMER identifiers must be valid UUIDs.
    - `identifier` string, required — Identifier of the entity to mute. Must be a UUID when type is CUSTOMER.
    - `type` 'CUSTOMER' | 'COUNTERPARTY', required — Type of entity the alert mute applies to.
  - `risk_code` string, required — Risk code/profile identifier to mute for the entity.
  - `risk_signal_identifier` string, uuid, nullable — Optional risk signal identifier associated with the alert mute.
  - `source_risk_app` 'UNSPECIFIED' | 'CUSTOMER_SCREENING' | 'PAYMENT_SCREENING', required — Risk application that produced the muted risk.

## Response `200`

Alert mute successfully created

- AmAlertMuteV3Response
  - `created_at` string, date-time, required — Timestamp when the alert mute was created.
  - `created_by` string, nullable — Identifier of the user that created the alert mute.
  - `entity` AmAlertMuteEntityResponse, required — Entity scope the alert mute applies to.
    - `identifier` string, required — Identifier of the muted entity.
    - `type` 'CUSTOMER' | 'COUNTERPARTY', required — Type of muted entity.
  - `identifier` string, uuid, required — Unique identifier of the alert mute.
  - `risk_code` string, required — Risk code/profile identifier muted for the entity.
  - `risk_signal_identifier` string, uuid, nullable — Risk signal identifier associated with the alert mute, when provided.

## Other responses

- `400` — Bad request
- `409` — Profile is already muted for this customer

---

[API](https://skmtc.dev/complyadvantage/apis/mesh-api.md) · [All operations](https://skmtc.dev/complyadvantage/apis/mesh-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/complyadvantage/mesh-api/revisions/fdaac4351d85/schema)