Skip to content

Track leads

Run a pipeline of enquiries from first contact through to a won job, and convert a won lead into a customer.

For office staffAvailable on Pro and EnterpriseLast reviewed
On this pageBefore you start

Leads are enquiries that have not become a job yet. Track each one through your pipeline, and convert it to a customer, or a customer and a job, once it is won.

Each new lead receives a job number when you save it, such as OR-0042. The number appears in the lead details from the start, where you can copy it, and in the pipeline once the lead is converted. It stays with the lead if you archive it, and carries across when you create the job.

Before you start

  • Your workspace's plan must include the Sales pipeline module. Plans and what each includes shows which plans do.
  • Adding, editing, advancing or converting a lead needs the owner, admin, dispatcher or office role. An individual person in any role can also be given a "Leads / CRM" grant to view the pipeline read-only, without being able to change anything in it.

Add a lead

  1. Open Leads.
  2. Select Add lead. A drawer opens on desktop. On a phone, it opens as a sheet.
  3. Enter the Company (required), and any of Contact name, Phone, Email, Source and Service you have.
  4. If you have permission, enter Estimated value. You can also choose an Owner, set a Follow-up date, add Lead details, and set a rough Projected start and Projected end.
  5. Select Add lead in the drawer.

ONYX1 reserves the next job number for the lead at this point. Existing leads created before job numbers were added do not receive a number automatically. When you convert one into a job, the new job gets a fresh number then.

Estimated value is visible only to the owner. The owner, follow-up date and lead details can be changed later by opening the lead and selecting Edit.

Website enquiries create a new lead for every clean message. If the same email address or phone number appeared in another enquiry in the last 24 hours, ONYX1 shows a possible-duplicate link for the owner or an admin to review; it does not change the existing lead. See Bring website enquiries into Leads for setup.

Each clean website enquiry also adds an automated Website enquiry note to its new lead. It records whether the enquiry came from the website form or connected website intake, a short summary of the request, and the attachment count. The note leaves out the sender's name, email and phone number. ONYX1 Office notes show the Office source and role; staff can read them but cannot edit or remove them.

When ONYX1 Office prepares a job proposal for a lead, only the owner or an admin can see its status in the lead drawer. While it is active, the drawer has a link to its review. Statuses include Preparing quote, Preparing job and schedule, Ready for approval and Stalled, needs a person. After a decision, the status is Applied, scheduled and assigned, Applied, scheduled, crew needed, Applied, dispatcher follow-up, Rejected, Expired or Stopped, ready to call. For a won lead with an active proposal, the drawer shown to the owner or admin replaces both Convert to customer and Convert + create job with a notice to review the proposal.

After approval, the owner or admin proposal panel links to the created job and draft quote. The quote is not sent. If the accepted-quote gate or pending safety-document approval blocks booking, the proposal shows dispatcher follow-up and the job remains unscheduled and unassigned. Any saved schedule suggestion is shown on the job for a dispatcher to consider. If a required pre-work safety pack is incomplete, approval is blocked and no customer, site, job or quote is created. If the reviewer keeps the date but omits crew, the job may be scheduled without an assignment. A rejected, expired or stopped proposal leaves the lead available for normal follow-up and manual conversion when appropriate. See Review a job proposal.

Find and review leads

The page shows an Active pipeline and, for owner and admin roles, an Archived view. The summary strip shows the open pipeline value, won leads this month, follow-ups due and proposals waiting when those values are available. The value is owner-only.

Use the New, Contacted, Proposal sent, Won and Lost chips to filter by stage. Each chip shows the number of matching leads. Search by company, contact or email, or use the owner filter to narrow the list. A follow-up date that is overdue is shown in amber. A draft job appears with a Draft mark and its title.

Select a lead to open its details. The drawer shows the company, contact details, source, service, job number, projected dates, follow-up, lead details, notes and activity. Phone and email details are links. Use the actions in the drawer to move the stage, convert a won lead, turn a draft into a job, archive a lead, or restore an archived lead. Activity names who made each change: a team member by name, ONYX1 Office by role (for example ONYX1 Office (Sales & Marketing Coordinator) after it triages an enquiry), and Website enquiry or Email enquiry for a lead an enquiry created. Owner and admin roles can select several active leads and archive them together.

Add and manage lead notes

The Lead details field is a short description saved with the lead. Use the Notes timeline for dated updates about conversations and follow-up.

  1. Open a lead and find Notes in its drawer.
  2. Select Add note, write the update, then select Save note. Notes appear newest first. A staff note shows the author's name, while an automated note shows its source label and, for Office, the role; both show when they were added.
  3. You can select Edit or Remove on a note you wrote. Other notes stay unchanged. Notes on an archived lead remain visible, but you cannot add, edit or remove them until the lead is active again.

Only the owner, admin, dispatcher and office roles can see or manage the Notes timeline. A Leads / CRM view grant does not include note access. Notes stay with the lead when it is converted to a job.

Move it through the pipeline

A lead moves through New, Contacted, Proposal sent and Won, or to Lost at any point. Open the lead and select the button for its next stage (for example Mark contacted), or Lost to close it out.

Convert a won lead

Once a lead is Won, select:

  • Convert to customer to create the customer record only, or
  • Convert + create job to create the customer and a job at the same time, carrying across the company, service and assignee.

The job keeps the lead's number and prefix. Repeating Convert + create job returns the existing job instead of creating another one. If the lead has no reserved number because it predates this feature, conversion allocates a new number at that time.

If the business requires the pre-work safety pack on new jobs, Convert + create job is refused: "This company requires the pre-work safety pack, so a job can’t be created straight from a lead. Use Convert to customer, then create the job from New Job with the pack."

Drafts from a site visit

A draft job captured after a site visit is also a lead, at stage New when it is saved. In the list it is marked Draft, with its title. See Capture a draft job after a site visit. A draft becomes a job through Turn into job on the draft, which keeps its photos and its number. On the lead, a draft shows Turn into job instead of Convert to customer and Convert + create job, and those two are refused for a draft. Moving a draft to Lost is the same as Not going ahead on the draft, and a draft closes as Won when it is turned into a job. Moving it along the stages here does not turn it into a job: use Turn into job.

If something goes wrong

  • Company is required. Enter a company name before saving.
  • Only business roles can add leads. You need the owner, admin, dispatcher or office role, or a Leads grant to view without editing.
  • A number appears to skip. Once a number has been saved, ONYX1 does not reuse it, including when a lead is archived or marked Lost. Gaps are expected when a reserved lead never becomes a job.