> For the complete documentation index, see [llms.txt](https://docs.aisera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisera.com/aisera-platform/tenant-setup/aisera-platform-configuration/tenant-configuration-settings/credential-notifications.md).

# Credential Notifications

The **Credential Notifications** section of the **Configuration** modal lets tenant Admins define who receives credential health alerts, how often digests are sent, and which types of credential events generate notifications. These settings apply to all integrations in the tenant. Admins can override recipient email addresses on a per-integration basis in the **integration wizard**.

### Enable Integration Credential Notifications

| **Type**    | Checkbox |
| ----------- | -------- |
| **Default** | Disabled |

Activates the tenant-wide credential notification system. When enabled, the Aisera Platform sends email alerts when integration credentials are nearing expiration or have failed authentication, based on the notification types and frequency configured in this section. When disabled, the Aisera Platform sends no credential alerts for any integration in the tenant.

### Recipient Emails

| **Type**    | Text field     |
| ----------- | -------------- |
| **Default** | Not configured |

Specifies the email addresses that receive credential notification digests for the tenant. Click **Add New** to add each address. Addresses configured here apply to all integrations unless an admin overrides them in the **integration wizard**.

### Failure Digest Frequency

| **Type**    | Dropdown |
| ----------- | -------- |
| **Default** | Daily    |

Controls how often the Aisera Platform sends credential notification digest emails. Set to **Daily** to receive a consolidated summary each day, or **Weekly** for a less frequent roundup. This setting applies across all integrations in the tenant. Admins cannot override it at the integration level.

### Notification Types

| **Type**    | Checkbox       |
| ----------- | -------------- |
| **Default** | Not configured |

Determines which credential events trigger alerts for the tenant. Select any combination of the following:

* **Proactive expiration reminders**: alerts before credentials expire, based on the known expiration date configured per integration.
* **Credential already expired**: alerts when credentials have passed their expiration date.
* **Auth failure at runtime**: alerts when an integration fails authentication during bot execution.
* **Auth failure during ingestion**: alerts when an integration fails authentication during data ingestion.
* **OAuth refresh-token failure**: alerts when an OAuth token cannot be refreshed.
* **mTLS / certificate validation failure**: alerts when a mutual TLS or certificate validation check fails.
* **Include test-connection failures**: extends alerts to cover failed test-connection attempts in the integration setup flow.

The Aisera Platform sends no alerts for event types that are not selected. This setting applies across all integrations in the tenant. Admins cannot override it at the integration level.

### Send immediately for critical events

| **Type**    | Checkbox |
| ----------- | -------- |
| **Default** | Disabled |

Sends email alerts immediately when a critical credential failure occurs, bypassing the configured digest schedule. Critical events are hard-coded and cover three scenarios: credentials already expired, OAuth refresh-token failure, and mTLS / certificate validation failure. Enable this when the digest cadence is too slow for failures that cause immediate bot disruption.
