Spend Management

Spend management is a way for you to notify 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
• Pause the production deployment of all your projects

The spend amount is set per billing cycle.

Setting the amount halfway through a billing cycle considers your current spend. You can increase or decrease your spend amount as needed. If you configure it below the current monthly spend, Spend Management will trigger any configured actions (including pausing all projects).

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 Vercel charges on a monthly basis.

Vercel checks your metered resource usage often to determine if you are approaching or have exceeded your spend amount. This check happens every few minutes.

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. Select the action(s) to happen when your spend amount is reached: pause all your projects, send notifications, or trigger a webhook URL

When you set a spend amount, Vercel automatically enables web and email notifications for your team. These get triggered when spending on your team reaches 50%, 75%, and 100% of the spend amount. You can also 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 icon and select the thresholds for which you would like to receive web and email notification, as described in Notifications
6. Repeat the previous step for the Web, Email, and SMS notification sections

In addition to web and email notifications, you can enable SMS notifications for Spend Management. They are only 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, scroll to SMS at the bottom of the page and toggle the switch to Enabled. 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

Vercel provides an option to automatically pause the production deployment for all of your projects when your spend amount is reached. This option is off by default.

1. In the Spend Management section of your team's settings, enable and set your spend amount
2. Toggle the Pause production deployment switch to Enabled
3. Confirm the action by entering the team name and select Continue. Your changes save automatically
4. When your team reaches the spend amount, Vercel automatically pauses the production deployment for all projects on your team

When visitors access your production deployment while it is paused, they will see a 503 DEPLOYMENT_PAUSED error.

Projects need to be resumed on an individual basis, either through the dashboard or the Vercel REST API.

Projects won't automatically unpause if you increase the spend amount, you must resume each project manually.

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

Vercel will 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 generated when 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. You can use this event to resume paused projects.

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

Vercel displays all spend management activity in the Activity tab of your team's dashboard. This includes spend amount creation and updates, and project pausing and unpausing.

For more information on Vercel's pricing, guidance on optimizing consumption, and invoices, see the following resources: