Spend Management

Spend management is a way for you to be notified or to automatically take action on your account when your team hits a set spend amount. The actions you can take are:

• Receive a notification
• Trigger a webhook

The spend amount is set per billing cycle. If you set the amount half way through the billing cycle, it will take into consideration your current spend. You can increase or decrease as needed, but if you decrease to an amount less than your current monthly spend, your notifications and webhooks will automatically be triggered.

The spend amount that you set covers metered resources that go beyond your Pro plan usage for all projects on your team.

It does not include seats or separate add-ons, which are charged on a monthly basis.

1. To enable spend management, you must have an Owner or Billing role on your Pro team
2. From your team's dashboard, select the Settings tab
3. Select Billing from the list
4. Under Spend Management, toggle the switch to enabled:

   

5. Set the amount in USD at which you would like to receive a notification or trigger an action
6. Manage your notifications or set a webhook endpoint

When you set a spend amount, Vercel automatically enables web and email notifications for when your team reaches 50%, 75%, and 100% of the spend amount. You can also optionally receive SMS notifications when your team reaches 100% of the spend amount. To manage your notifications:

1. You must have an Owner or Billing role on your Pro team
2. From your team's dashboard, select the Settings tab
3. Select My Notifications from the list
4. Under Team, ensure that Spend Management is selected
5. Select the settings icon and select the thresholds for which you would like to receive web and email notification, as described in Notifications
6. Repeat this action for the Web, Email, and SMS notification sections

In addition to web and email notifications, you can enable SMS notifications. SMS notifications can only be configured for Spend Management and will only be triggered when you reach 100% of your spend amount.

To enable SMS notifications:

1. You must have an Owner or Billing role on your Pro team. Note that following these steps only configures your SMS notifications. Each member with an Owner or Billing role can configure their own SMS notifications for Spend Management
2. Set your spend amount
3. From your team's dashboard, select the Settings tab
4. Select My Notifications from the list and scroll to SMS at the bottom of the page. Use the toggle to enable this feature. If your personal profile has a phone number associated with it, SMS notifications will be enabled by default
5. Under Team, ensure that Spend Management is selected
6. Enter your phone number and follow the steps to verify it

You can configure a webhook URL to trigger events such as serving a static version of your site, pausing a project, or send a Slack notification.

Vercel will automatically and instantly send a HTTPS POST request to the URL that you provide when the following events happen:

• When a spend amount reaches 100%
• At the end of your billing cycle

To configure a webhook for spend management:

1. In the Spend Management section of your team's settings, set your spend amount
2. Enter the webhook URL for the endpoint that will receive a POST request. In order to be accessible, make sure your endpoints are public
3. Secure your webhooks by comparing the x-vercel-signature request header to the SHA that is randomly generated once you save your webhook. To learn more, see the securing webhooks documentation

The webhook URL receives an HTTP POST request with the following JSON payload for each event:

Sent when the team hits 100% of their spend amount.

{
  "budgetAmount": 500,
  "currentSpend": 500,
  "teamId": "team_jkT8yZ3oE1u6xLo8h6dxfNc3"
}

Sent when the billing cycle ends. This event be used to resume projects that have been paused.

{
  "teamId": "team_jkT8yZ3oE1u6xLo8h6dxfNc3",
  "type": "endOfBillingCycle"
}