---
schema_version: "1"
id: b53e4bf3e6f2dc4aca9551b2f70da9deb94dae1fc276e24227a034e1bd2cc558
title: Create an API Usage Notification
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/monitor_rate_limit_edit.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.monitor_rate_limit_edit.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 60049cadb6d297f820e142425640d4160f7789c8cb36f0ec7cbec461a6013c53
description: On the API Usage Notifications page, you can supply the required values for a rate-limiting notification.
products:
  - Salesforce Platform
release: "264"
---
# Create an API Usage Notification

On the API Usage Notifications page, you can supply the required values for a rate-limiting notification.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: both Salesforce Classic and Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, <strong>Developer</strong>, and <strong>Database.com</strong> Editions</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d19582e75">User Permissions
              Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d19582e75 ">To view, create, edit, or delete notifications:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d19582e75 ">Modify All Data</td>

          </tr>
        </tbody>
      </table>

1. From Setup, enter API Usage Notifications in the Quick Find box, then select **API Usage Notifications**.
2. Click **New**.
3. Enter the details.
    
    - Notification Recipient: The Salesforce user who will receive the notifications.
    - Threshold: The percentage of the rate limit that, once exceeded in the specified notification interval, triggers a notification to be sent to the specified user. Value must be between 0 and 100.
    - Notification Interval (Hours): The time period for which the number of requests is measured, in hours. For example, if the interval is 24, the rate must be exceeded in the past 24 hours for a notification to be sent.
        
        If you change the time period, the new time period does not take effect until after the next notification of the existing time period. For example, assume you have set the time period to send notifications every hour. Then at 4:05 p.m., you set the time period to send notifications every 24 hours. A last notification from the old time period is sent at 5:00 p.m. The next notification would be sent at 5:00 p.m. the next day.

#### See Also

- [View API Usage Notifications](https://help.salesforce.com/s/articleView?id=platform.monitor_rate_limit_detail.htm&release=264.0.0&type=5 "You can view, edit, delete, or clone information about a API usage notification.")
- [Manage API Usage Notifications](https://help.salesforce.com/s/articleView?id=platform.monitor_rate_limit.htm&release=264.0.0&type=5 "When you create a request usage notification, you specify an administrator to receive an email notification whenever your organization exceeds a specified limit for the number of API requests made in a specified span of hours.")