Skip to content

Tracking a sale with deals

A lead is an enquiry. A deal is the sale it leads to: what is being sold, for how much, and when it is expected to close. One customer can bring several deals, and an enquiry stays on record after its deal is won or lost.

Your workspace may call deals something else. See Terminology.

Before you start

  • You need tenant.deals.view to see deals and tenant.deals.create to add one. Owners, Administrators, Managers and Callers have both.
  • Moving a deal between stages, including marking it won or lost, needs tenant.deals.move_stage.
  • You need at least one pipeline that carries deals. See Pipelines.

Steps

Create a deal from a lead

  1. Open the lead.
  2. Click Create deal.
  3. Fill in the name, value, expected close date and stage. The deal takes the lead's contact and owner, and you can change them.
  4. Save.

The lead itself is not changed. You can also create a deal with no lead from Deals → New deal.

Move a deal forward

  • On the deal's page, use Move stage.
  • Or open Deals → Board to see every deal in a pipeline by stage.

If a stage needs a reason, such as a lost stage, you are asked for one.

Win or lose a deal

Move it to a won or lost stage. The deal's page then shows Won or Lost, the date, and the reason given.

What this affects elsewhere

  • When a deal is won, its lead moves to its pipeline's won stage too, and the lead's timeline records why.
  • From a deal you can create a quotation or an invoice, if the Commercial module is on. See Quotations.
  • If ad conversions are on, a won deal that came from a lead can be reported to Meta as a purchase.
  • Incentive rules can pay for deals won or for their value. See Incentives.

What you cannot change later

Stage history is append-only. Every move is recorded and stays recorded, even if the deal is moved back.

Deleting a deal archives it. It leaves the lists but stays in history and reports.

If it does not work

What you see What it means What to do
No pipeline is set up for deals yet No pipeline is allowed to carry deals In Settings → Pipelines, set a pipeline to carry deals, or both leads and deals
You cannot move a deal You do not have tenant.deals.move_stage Ask a manager to move it, or ask for the permission
The stage refuses to save That stage needs a reason Enter the reason and save again

Last checked against the product on 2026-11-07. Needs the tenant.deals.view permission.