Approval workflows
Approval workflows let you define custom rules that require review when a quote, invoice, or credit note meets specific criteria. Each workflow can contain multiple approval steps with individual or role-based approvers.This feature is available on demand. Contact our support if you are interested.
Configure approval workflows
To set up approval workflows:- Go to Settings > Approvals
- Open Approval workflows
- Click Create workflow to add a new approval workflow
- Under Applicable flows, select the actions that should trigger the workflow
- Configure the workflow rules and approval steps
- Save the workflow
Applicable flows
Choose one or more flows for each workflow:- Quote for new subscription
- Quote for subscription update
- Quote for one-off invoice
- Invoice finalization
- Credit note finalization
An approval workflow does not make invoices or credit notes draft by itself.
Configure draft invoice behavior separately when documents generated from
subscriptions should stop for review before finalization.
Rules
Rules determine when an action requires approval. You can combine multiple conditions using AND/OR logic.
When you select more than one applicable flow, Hyperline only offers conditions supported by every selected flow. Changing the applicable flows removes any condition that is no longer compatible.
For quote payment method conditions, subscription quotes use the customer’s payment method, while one-off quotes use the payment method selected on the linked invoice.
Via the API, Quote attachment maps to the
has_attachment field. Use eq with false to require approval when no attachment is present, or eq with true to require approval when one is present.
Example 💡
You can create a workflow for invoice and credit note finalization that requires approval when:
- The total amount exceeds $50,000 OR
- The discount percentage is greater than 20% OR
- A specific premium product is included OR
- The document uses card payment
Approval steps
Each workflow can include one or multiple approval steps. Steps are processed sequentially—a request must complete all steps before it is fully approved. For each step, you can configure:- Step name: A descriptive name for the approval step (e.g., “Sales Manager Review”, “Finance Approval”)
- Approvers: Select individual team members or roles. For quote flows, you can also use the Manager of quote owner option (see below)
- Approval requirement: Choose whether all approvers must approve or if any approver can complete the step
- All approvers: Every selected approver must approve before moving to the next step
- Any approver: Only one approval from the selected approvers is needed
Example 💡
A three-step approval workflow for large deals:
- Sales Manager Review (any sales manager can approve)
- Finance Approval (any finance team member can approve)
- Executive Sign-off (the CFO or CEO must approve)
Manager of quote owner
Rather than naming approvers explicitly, a step can require approval from the manager of the quote owner. Hyperline resolves that manager every time approval is requested, from the manager set on the owner’s member profile — see Set a member’s manager. This keeps a single workflow valid across an entire sales team: every quote is routed to its own owner’s manager, instead of maintaining one workflow per team. The resolved manager is notified and reviews the quote like any other approver. You can combine this option with individual approvers and roles on the same step.Example 💡
One workflow requires approval when the discount exceeds 20%, with a single step set to Manager of quote owner. A quote owned by a rep in the EMEA team goes to the EMEA manager, while the same workflow routes a US rep’s quote to the US manager.
- Changing the quote owner while the quote is pending approval re-routes the step to the new owner’s manager.
- Changing a member’s manager while a quote is pending approval hands the step to the new manager, who is notified.
- A quote owner can never approve their own quote through this option, since a member cannot be their own manager.
- If the quote owner has no manager and the step also names members or roles, those approvers still decide the step.
- If the step that cannot resolve is followed by a step with approvers, the quote opens on the first step somebody can decide.
- A manager whose membership is archived or deactivated counts as no manager.
Notifications
When an approval request is created, Hyperline automatically notifies the relevant approvers:- Email notifications: Approvers receive an email when their approval is needed
- Delegated approver notifications: If an approver has an active delegation, the delegated approver also receives the approval request email
- Slack notifications (optional): You can connect a Slack channel to each approval workflow. When approval is needed at any step, a notification is sent to the configured channel with details about the resource, requester, workflow step, and approvers
Workflow priority
If you have multiple approval workflows, you can set their priority order. When an action matches multiple workflows, only the workflow with the highest priority (lowest number) is applied. To adjust priority, drag and drop workflows in Settings > Approvals > Approval workflows.Approval delegations
Approval delegations let an approver temporarily give another active team member the ability to approve or reject requests on their behalf. Use them when an approver is out of office or when another team member needs to cover approvals for a defined period. A delegated decision counts as a decision from the original approver, while Hyperline also records which user actually approved or rejected the request.Example 💡
A finance manager is away for one week and delegates approvals to another
finance team member. During that week, the delegated approver receives
approval requests, can approve or reject them, and their decisions count as
the finance manager’s decisions in the workflow.
Create an approval delegation
To create a delegation:- Go to Settings > Approvals
- Open Delegations
- Select the original approver whose approvals should be delegated
- Select the new approver who should receive the delegated approvals
- Choose the delegation start and end dates
- Add a reason, if needed
- Save the delegation
The original approver, new approver, and user creating the delegation must be
active team members. A user cannot delegate approvals to themselves.
How delegated approvals work
During the delegation period, the delegated approver receives requests assigned to them through the delegation, alongside requests assigned to them directly. When the delegated approver approves or rejects a request:- The workflow treats the decision as coming from the original approver
- Hyperline records who acted on behalf of the approver
- The same All approvers and Any approver step rules still apply
Manage delegation periods
Delegations are time-bound. A delegation only applies between its start and end dates, and you can revoke it before the end date if it is no longer needed. Keep these rules in mind:- Expired and revoked delegations no longer grant approval rights
- Inactive users are excluded from delegated approval filters and notifications
- An approver cannot have overlapping active delegations for the same period
- Past delegated decisions remain in the approval history after a delegation expires or is revoked
Approval process
For invoice and credit note creators
When you submit a draft invoice or credit note for finalization and it matches an approval workflow:- The document moves to
pending_approvalinstead of being finalized - The document page shows the workflow that was triggered, the current step, and the approval history
- If the request is approved, Hyperline finalizes the document automatically
- If the request is rejected, the document moves to
changes_requested
For quote creators
When you create a quote that matches an approval workflow:- After validating the quote, it automatically moves to Pending approval status
- You’ll see which approval workflow was triggered and which step is currently active
- You receive email notifications when:
- Your quote is approved and ready to send
- Your quote is rejected with a reason from the approver
- An approver requests changes (quote moves to Change requested status)
- Edit the quote to address the approver’s feedback, then resubmit for approval
- Void the quote if you decide not to proceed
For approvers
When a quote, invoice, or credit note requires your approval:- You receive an email notification (and a Slack notification if configured)
- Open the resource from the email or Slack link. For quotes, you can also use the Need your approval filter in the quotes list. For invoices and credit notes, filter the invoice list by Pending approval.
- Review the resource details and approval history
- Click Approve or Reject:
- Approve: The request moves to the next approval step. After the final step, Hyperline approves the quote or finalizes the invoice or credit note.
- Reject: You can provide a reason or comment. The resource moves to Changes requested, and the creator is notified.
Quote statuses
Quotes in the approval process can have the following statuses:- Pending approval: The quote is waiting for approval at one or more steps
- Change requested: An approver rejected the quote and requested changes. The quote creator must edit the quote or void it
- Approved: All approval steps are complete. The quote can now be sent to the customer for signature
Invoice and credit note statuses
Invoices and credit notes in the approval process can have the following statuses:pending_approval: The document is waiting for approval at one or more steps. It remains unfinalized.changes_requested: An approver rejected the request. Edit and save the document to resubmit it, or delete it.
Simple quote approval permission
When the approval workflows feature (described above) is not enabled, Hyperline provides a dedicated quote approval permission. When a user without this permission creates and validates a quote (from the UI or a CRM), the quote moves into a Pending approval state and requires another user with the approval permission to approve it before it can be sent for signature. In this flow, Hyperline does not offer automatic notifications to users with the quote approval permission when a quote requires approval. However, you can set up dedicated notifications (email, Slack message, etc.) using external workflow tools like Zapier or custom code. Hyperline provides a dedicated webhook event —quote.approval_requested — triggered whenever a quote is saved and requires approval.
