BeigeCRMGUIDE

Sales

Preview only. An unreviewed draft. Not visible on the public site. Every review flag below must be cleared before this page can be published.

Leads

A lead is someone who might become a customer but hasn't been qualified yet. Leads live separately from People and Companies so your contact records stay clean — a lead only becomes a Person when you convert it.

Every lead belongs to exactly one organization, and email is unique per organization. Submitting the same email address twice updates the existing lead rather than creating a duplicate.

The Leads page showing the list view with score, source, and pipeline stage columns
The Leads page showing the list view with score, source, and pipeline stage columns

Creating leads#

Leads arrive four ways:

RouteHow it works
ManuallyAdd Lead on the Leads page.
Web formsA published form creates a lead on submission, using the field mappings you set in the form builder.
AutomationsAn automation step can create a lead; the lead records which automation produced it.
APIPOST /v2/org/:orgSlug/crm/leads

The Add Lead dialog asks for a name, email, phone, pipeline, stage, and source. Only email is strictly required — but the more you fill in, the higher the lead scores, and a phone number alone is worth 8 points.

The Add Lead dialog with its available fields
The Add Lead dialog with its available fields

Pipeline stages#

Leads move through a lead pipeline — a named, ordered set of stages your team defines. New organizations start with General Lead Pipeline, and you can rename, reorder, recolor, or add stages to match how your team actually sells.

Stage is the main thing you'll work with: it's the column in Kanban, a filterable column in the list, and what you change when a lead progresses. Because stages are yours to define, the stage names in your account won't match any example here.

Kanban view with leads as cards in pipeline stage columns
Kanban view with leads as cards in pipeline stage columns

Lead scoring#

Every lead carries a score from 0 to 100 that answers "how warm is this?". The score is additive and always explainable — open a lead to see the exact breakdown behind its number.

Score = Profile fit + (Engagement × recency decay) + Pipeline progress

ComponentMaxWhat it measures
Profile fit30Who they are — contactability and where they came from. Fixed at capture.
Engagement50What they did. The strongest buying signal, and the only part that decays.
Pipeline progress20How far a human has moved them through the pipeline.

Profile fit rewards a phone number (8), both names (6), and a business email domain rather than Gmail or Outlook (6), plus source quality — a referral is worth 10, website 8, social 5. Cold outreach scores 0: someone who asked to be contacted is worth more than someone who was found.

Engagement counts behavior, with a per-signal cap so one noisy channel can't dominate:

SignalPointsCap
Form submission1515
Deal created1515
Inbound email (they replied)918
Completed call612
Completed task39
Note added26
Outbound email (you wrote)26

Outbound email is deliberately weighted low — it's effort spent, not interest shown.

Recency decay multiplies the engagement subtotal only: full value within 7 days, ×0.8 within 30, ×0.5 within 90, ×0.25 beyond. Profile fit and pipeline progress are facts that don't go stale; enthusiasm does.

Scores land in four bands: Cold (0–29), Warm (30–59), Hot (60–79), Very hot (80–100).

A lead's score breakdown showing which signals contributed which points
A lead's score breakdown showing which signals contributed which points

Working the list#

The Leads page offers three views:

  • Kanban — leads as cards in stage columns
  • List — the standard table with pagination and bulk selection
  • Grid — a dense spreadsheet view with inline editing, resizable columns, and a column picker
Grid view with inline cell editing and the column picker open
Grid view with inline cell editing and the column picker open

Search matches across leads, and filters narrow by source, tags, and date range. Sort by created date, updated date, name, email, or score.

Select multiple leads to delete them or assign tags in bulk.

The lead detail page#

Opening a lead shows its profile alongside six tabs:

  • Activity — the timeline of what's happened
  • Notes — free-text notes from the team
  • Tasks — follow-up work linked to this lead
  • Deals — deals created from this lead
  • Emails — correspondence
  • Attachments — files
Lead detail page showing the profile panel and the six tabs
Lead detail page showing the profile panel and the six tabs

Leads can be assigned to a team member and tagged freely — both are edited from the lead's detail page.

Turning a lead into a deal#

When a lead is real, open it and use Create Deal in Quick Actions. The dialog collects the deal title, description, value, pipeline, stage, probability, and expected close date — and pre-fills Related To: Lead with this lead, so the new deal stays linked to where it came from.

The Create Deal dialog opened from a lead, pre-linked to that lead
The Create Deal dialog opened from a lead, pre-linked to that lead

The deal then appears under the lead's Deals tab. The lead itself is not deleted or changed — it stays as the record of origin.

Permissions#

Every lead query is scoped to the organization in the URL — members of one organization cannot see, search, or bulk-edit another organization's leads.

Last updated Wed Aug 05 2026 00:00:00 GMT+0000 (Coordinated Universal Time)