> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cassidyai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Credit usage alerts and limits

> Monitor organization-wide credit consumption and set per-user spending caps to keep your team's AI usage in check.

Cassidy gives you two layers of credit visibility: **organization alerts** that track your team's total usage against the allowance for your billing period, and **per-user alerts and limits** that monitor and cap individual consumption. Both are configured in **Organization Settings → Limits & Alerts**.

> [!NOTE]
>
> Only **Admins** can configure credit alerts and limits.

***

## Organization alerts

Organization alerts notify admins when your organization's **total** credit usage crosses a threshold you define. They are **informational only** — they don't restrict usage.

### Add an alert

**1. Open organization settings**

Open your account menu from the sidebar and select **Organization
Settings**.

**2. Navigate to Usage Limits**

In the left sidebar, click **Limits & Alerts** under the **Usage** section.

**3. Open the Organization Alerts section**

Expand **Organization Alerts** at the top of the page, then click **Add alert**.

![Organization Credit Alerts on the Limits & Alerts page](https://mintcdn.com/cassidy/fi7HFyccoyB8r0IA/images/settings/organization-credit-alerts-section.png?fit=max\&auto=format\&n=fi7HFyccoyB8r0IA\&q=85\&s=c783f68a65f83e59aa19c96f4addff64)

**4. Choose a threshold type**

Select how the threshold should be measured:

| Type | Description | Example |
| - | - | - |
| **Percentage** | A percentage of your organization's credit maximum for the billing period | Alert at 75% of 10,000 credits = fires at 7,500 credits used |
| **Absolute** | A fixed number of credits | Alert at 8,000 credits, regardless of the maximum for the billing period |

> [!TIP]
>
> Percentage thresholds automatically scale if your credit allowance changes. Absolute thresholds give you a precise spending target.

![Adding an Organization Credit Alert](https://mintcdn.com/cassidy/fi7HFyccoyB8r0IA/images/settings/add-org-credit-alert-modal.png?fit=max\&auto=format\&n=fi7HFyccoyB8r0IA\&q=85\&s=c3b025da9ed9c10fb52b3968eeebb5fb)

**5. Set the threshold value**

Enter the percentage (1–100) or credit count that should trigger the alert.

**6. Choose who to notify**

Select either **All Admins** or **Specific Admins**. If you choose specific admins, use the selector to pick who should receive the alert email.

![Selecting admins to notify when the alert triggers](https://mintcdn.com/cassidy/fi7HFyccoyB8r0IA/images/settings/org-credit-alert-admins.png?fit=max\&auto=format\&n=fi7HFyccoyB8r0IA\&q=85\&s=d5b9667b1b7f6f16ae1011212dcbe84f)

**7. Save**

Click **Add** to activate the alert.

> [!TIP]
>
> The alert will fire the first time your organization's credit usage crosses the threshold within each billing period.

### How organization alerts work

* Each alert fires **once per billing period**. Usage dropping below the threshold and climbing back above it will not re-trigger the alert until the next billing period resets.
* You can configure **multiple alerts** at different thresholds — for example, one at 50% and another at 90% — to get early warnings and final notices.
* To change a threshold or notification recipients, click the **pencil icon** next to an alert. To remove an alert, click the **trash icon**.

> [!WARNING]
>
> Editing an alert's threshold resets it so it can fire again in the current
> billing period. If your organization is already past the new threshold, the
> alert will trigger immediately.

***

## Per-user alerts and limits

Per-user controls let you notify admins when individual team members exceed a credit threshold, and optionally enforce a **hard cap** that blocks users from consuming additional credits once their limit is reached.

### Check your usage remaining

When per-user credit limits are active and usage visibility is enabled, open your account menu in the sidebar and point to **Usage Remaining**. The flyout shows the percentage of your credits remaining, the credits used, and when the limit resets.

For limits that do not reset, the flyout shows **All time** instead of a reset date. If you reach your limit, the flyout directs you to an admin or, if you can manage usage limits, to **Organization Settings → Limits & Alerts**.

### Set up per-user credit usage alerts

Credit usage alerts notify selected admins, the user whose activity triggered the alert, or both when a team member crosses a configured threshold. You can create multiple alerts with different thresholds and periods. Alerts are **informational only** — they don't block users from consuming additional credits.

**1. Open organization settings**

Open your account menu from the sidebar and select **Organization
Settings**.

**2. Open user credit alerts**

In the left sidebar, click **Limits & Alerts** under the **Usage** section. Find **User Credit Alerts**, then click **Add alert**.

![User credit alerts section on the Limits & Alerts page](https://mintcdn.com/cassidy/fk_UFkuoS8dF6mDf/images/settings/user-credit-alerts-area.png?fit=max\&auto=format\&n=fk_UFkuoS8dF6mDf\&q=85\&s=9476cd0d2c7fb833cbc62fed27cc3871)

**3. Set the threshold and period**

Enter the number of credits that triggers the alert, then choose whether Cassidy measures usage by day, week, month, or billing period.

**4. Choose recipients**

Turn on **Notify the user who triggered the alert** to email the team member whose usage crossed the threshold. Choose **All Admins** or **Specific Admins** for the admin recipients.

**5. Add an optional message**

Enter a message to include extra context or instructions in the alert email. Each alert can have a different message.

![User credit limit modal showing credit limit, period, recipients, and optional message](https://mintcdn.com/cassidy/fk_UFkuoS8dF6mDf/images/settings/user-credit-alerts-modal.png?fit=max\&auto=format\&n=fk_UFkuoS8dF6mDf\&q=85\&s=16ed1c3118bad363bec9f326f63f0ce8)

**6. Add the alert**

Click **Add** to activate the alert. Repeat these steps to create more thresholds.

> [!TIP]
>
> Each alert sends one email per user during its configured period. Editing an alert lets the updated alert fire again if the user is already above its threshold.

### Set up per-user credit limits

Per-user credit limits set a **hard cap** on how many credits each team member can consume per billing period. When a user hits their limit, they are blocked from credit-consuming actions and shown an explanation.

**1. Enable per-user credit limits**

On the **Limits & Alerts** page, toggle on **Per-User Credit Limits**.

![Per-User Credit Limits toggle enabled on the Limits & Alerts page](https://mintcdn.com/cassidy/4vOVgS8tIBDNrgx6/images/settings/per-user-limits-toggle.png?fit=max\&auto=format\&n=4vOVgS8tIBDNrgx6\&q=85\&s=c709f29bc4ce304588b2e26a28538d06)

**2. Set the default limit**

Under **Default Limit Per User**, specify the credit limit that applies to all users (e.g., 1000 credits per billing period).

![Default Limit Per User field showing the credit limit per billing period](https://mintcdn.com/cassidy/4vOVgS8tIBDNrgx6/images/settings/per-user-credit-limits.png?fit=max\&auto=format\&n=4vOVgS8tIBDNrgx6\&q=85\&s=cfea5cc3a9df36276c0a3e8d03b33185)

**3. Choose whether users can see usage remaining**

Leave **Show Usage Remaining to Users** on to show the **Usage Remaining** flyout in each user's account menu. Turn the setting off to hide the flyout from users. The setting is on by default.

**4. Select admins to notify**

Choose which admins should receive email notifications when any user hits their credit limit.

![Admins to Notify selector for per-user credit limits](https://mintcdn.com/cassidy/4vOVgS8tIBDNrgx6/images/settings/per-user-limits-admins.png?fit=max\&auto=format\&n=4vOVgS8tIBDNrgx6\&q=85\&s=ab2c12d0ff87c4eb1771e300477db7b1)

**5. Configure exclusions (optional)**

Toggle on the following options if you want to exclude certain usage from counting toward credit limits:

* **Exclude Agent External Deployments from Credit Limits** — Credits used by externally deployed [Agents](https://docs.cassidyai.com/agents/overview.md) won't count toward user limits.
* **Exclude Workflows from Credit Limits** — Credits used by [Workflows](https://docs.cassidyai.com/workflows/overview.md) won't count toward user limits.

![Exclusion toggles for Agent deployments and Workflows](https://mintcdn.com/cassidy/4vOVgS8tIBDNrgx6/images/settings/per-user-limits-exclusions.png?fit=max\&auto=format\&n=4vOVgS8tIBDNrgx6\&q=85\&s=f5473cd23db5206c83ef77e2275e3c67)

> [!TIP]
>
> Excluding Workflow and deployment credits is useful when those are shared team resources, not individual consumption.

**6. Add custom limits for specific users (optional)**

Click **Add Custom Limit** to override the default limit for individual users. Select the user and set a specific credit cap, or leave them unlimited.

![Add Custom Limit button for overriding per-user credit limits](https://mintcdn.com/cassidy/4vOVgS8tIBDNrgx6/images/settings/per-user-limits-add-custom.png?fit=max\&auto=format\&n=4vOVgS8tIBDNrgx6\&q=85\&s=e85086d8ab1af170e8075d0406769bdc)

![Custom limit configuration showing user selection and credit limit value](https://mintcdn.com/cassidy/4vOVgS8tIBDNrgx6/images/settings/per-user-limits-custom-value.png?fit=max\&auto=format\&n=4vOVgS8tIBDNrgx6\&q=85\&s=f57bce6d8d1141153c29aace531a32fa)

**7. Monitor users exceeding their budget**

Review the **Users Exceeding Credit Budget** section to see which users have exceeded their credit limit in the current billing period, along with their current usage and limit.

![Users Exceeding Credit Budget section showing users who hit their limit](https://mintcdn.com/cassidy/4vOVgS8tIBDNrgx6/images/settings/per-user-limits-exceeding-budget.png?fit=max\&auto=format\&n=4vOVgS8tIBDNrgx6\&q=85\&s=06e462a504d3475433fc362054e69dca)

**8. Save**

Click **Save** to apply your credit limit configuration.

> [!TIP]
>
> Per-user credit limits are now active. Limits reset at the start of each billing period. Custom limits take precedence over the default limit.

***

## Comparison

| | Organization alerts | Per-user alerts | Per-user limits |
| - | - | - | - |
| **What triggers it** | Total organization usage crosses a threshold | An individual user crosses a threshold | An individual user hits their cap |
| **Threshold types** | Percentage or absolute | Absolute credits | Absolute credits |
| **Restricts usage?** | No | No | Yes — blocks AI features |

All three can be used together. For example, set an organization alert at 80% to track overall spend, per-user alerts to catch high individual usage early, and per-user limits to enforce a hard ceiling.

## Next steps

> [card] [Manage credits](https://docs.cassidyai.com/settings/manage-credits.md)
>
> Understand how credits work and check your balance.

> [card] [Monitor usage](https://docs.cassidyai.com/settings/monitor-usage.md)
>
> Track credit, storage, and meeting usage across your organization.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.