Require approvals for deals

You can set up an approval process for a deal pipeline so that deals must be reviewed and approved before progressing down the pipeline. When pipeline approvals are turned on, an approval stage is added to the selected pipeline and users will be unable to move deals past that stage without approval, except to a closed lost stage.

Each pipeline can have a unique approval stage with up to three approvers. For example, you may have one sales process that needs approval from a sales manager before closing and another sales process that needs both legal and manager approval before sending a contract.

If you're an admin, learn how to set up the deal approval process. If you're a user working with deals, learn how to request approval. If you're an approver, learn how to review deals that require approval.

For additional help setting up the approval process, refer to the video walkthrough shared in the HubSpot Community.

Grant deal approval permission to users

Before you can assign deal approvers, you'll need to give these users deal approval permissions.

Please note: it's recommended to grant approval permission first before setting up a pipeline approval process. It may take several minutes for users with updated permissions to appear as available approvers in the set-up process.

• In your HubSpot account, click the settings settings icon in the top navigation bar.
• In the left sidebar menu, navigate to Users & Teams.
• Hover over a user, then click Edit permissions.
• Click to expand the Deals section, then toggle the Approve permission on.

• Click Save.

Set up deal approval for a pipeline

Users with Super Admin permissions can set up an approval stage and assign approvers for each deal pipeline. Once you've turned on the approval process, you can also edit the approval stage and which users are approvers.

Before turning on deal approvals, make sure you've granted the approvers the Approve deal permission.

• In your HubSpot account, click the settings settings icon in the top navigation bar.
• In the left sidebar menu, navigate to Objects > Deals.
• Navigate to the Pipelines tab.
• Click the Select a pipeline dropdown menu, then select the pipeline for which you want to require approvals.
• At the bottom, click the Pipeline Rules tab.
• In the Add approval process for deals row, toggle the switch on. If it's already turned on, click the edit edit icon to edit the process.

• In the right panel, set up the approval stage. The approval stage will be highlighted and called Pending approval by default.
  • To change the stage's name, click the stage name text box, and enter a name.
  • To set the stage's probability, click the probability dropdown menu, then select a percentage.
  • To change the position of the stage, click and drag the stage to the desired position in the pipeline order. Users will need to get approval to move a deal past the approval stage, except for moving deals to a closed lost stage.

• Click Next: Add approvers to select which users can approve deals.
• To select approvers, click the Add approvers dropdown menu, then select the checkboxes of users you want to be approvers. You can add up to three approvers per pipeline.
• Select whether approval is required from All approvers or Any one of the approvers. If you select All, all selected approvers must approve a deal before it can move forward in the pipeline. If you select Any, only one approver must approve the deal before it can move forward in the pipeline.
• To add a note to the approvers, enter text in the text box. This is a required field is shown to approvers when a deal needs approval.

• Click Next: Review.
• Review the approval stage and approvers, then click Save.

Once saved, all deals must enter the approval stage and get approval before they can move forward in the pipeline, unless moving directly to the closed lost stage. Any deals already in a stage at the time of set-up the approval stage won't be subject to the approval process.

Please note: while not recommended, Super Admins can turn off an existing deal pipeline's approval process by toggling the Add approval process for deals row switch off. If the approval is turned off, the approval stage will become a normal stage and all approvals will be cancelled regardless of their status. You can't undo the action if you turn off an approval process, so if you want to reinstate approvals, you'll need to set up a new approval stage.

Request approval for a deal

If you're a user moving deals through a pipeline, your deals must enter the approval stage and be approved before they can move down the pipeline. For the deal approval process to start, the deal must have an owner and the deal owner must not be the only approver or an approver when all approvers are required.

Please note: a deal’s approval process will not start if there's no deal owner, the owner is a required approver, or if any assigned approver has lost deal approval permission or been deactivated. In this scenario, a Restart button will appear on the deal card in board view with a description of the error and next steps.

To request approval:

• In your HubSpot account, navigate to CRM > Deals.
• Move the deal to the approval stage. You can update the deal stage manually, via API, or via workflows.
• Once a deal is in the approval stage, approvers are sent a request to approve the deal. The deal will have an approval status (e.g., Pending approval) that appears on a deal card in board view, or in the Latest approval status column in list view.

• To view more information about the approval process, on a deal card in board view, click Details > View approval activity.
  • On the Approval tab, view approval notes, the users who need to approve the deal, and changes to the approval status.
  • Click the Comments tab to view or add comments. To add a comment, enter text in the comment box, then click Comment.
• Once an approver has approved, rejected, or requested changes to the deal, the deal owner will receive a notification in HubSpot and via email.
  • If the approver requested changes, view the comments. If needed, make changes and reply to the approver's comments so they can approve the deal.
  • If approved, the approval status will change to Approved and you can move the deal forward to the desired stage.
  • If rejected, the approval status will change to Rejected and the deal can only be moved to a closed lost stage.

Approve or reject a deal

If you're an approver for a deal pipeline, you'll receive a notification in HubSpot and via email when a user requests deal approval.

• To view the deal from your notifications, navigate to your notifications in HubSpot or your email, then click the notification or CTA to go to the deal.

• To view all deals waiting for approval, filter your deals by Latest Approval Status contains exactly pending. Click the name of a deal included in the view.

On a deal record, to approve or reject the deal:

• At the top of the deal, in the Approval needed banner, click Approval.
• To view more information about the request, select View Approval Details.
• To request changes prior to approving, select Request changes. Enter text in the comment box, then click Comment. The user that requested the approval will be notified.
• To approve the request to move the deal forward, select Approve. Enter an optional message, then click Approve to confirm.

• To reject the deal, select Reject. Enter a reason why the deal was rejected, then click Reject to confirm.

Please note: you cannot undo the action if you reject a deal. Once a deal is rejected, it can only be moved to a closed lost stage. If you'd allow the deal to move forward with edits, you should request changes rather than rejecting.