Lead
A Lead is a Contact who raised a hand, by joining a Waitlist, filling a Form, or replying, without accepting an Offer.
Accepting an Offer, at any Price, makes a Lead a Customer.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
interest | text | What the Lead asked for. | |
status | string | required | One of new, working, nurture, converted, or disqualified. |
owner | Worker | The Worker who answers it. | |
fit | string | One of strong, partial, or none: fit to the ICP as the Lead fit Policy grades it, never set by hand. |
Inherited from Contact: 3 properties
| Property | Type | Required | Description |
|---|---|---|---|
email | email | The primary email address. | |
phone | string | The primary phone number. | |
name | string | The name the Contact goes by. |
Object
{
"$id": "https: //api.sb/ quietcopy.com/ leads/ lead_1",
"$type": "Lead",
"email": "mei@quietcopy.com",
"phone": "Example phone",
"name": "QuietCopy",
"interest": "Example interest",
"status": "new",
"owner": "worker_1",
"fit": "strong"
}Relationships
- A Lead is acquired by one Acquisition: each Lead keeps the Acquisition that first brought it, through either door: a Visit or an outbound reply.
acquiredBy, inverseleads. - A Lead is captured by one Form: each Form submission creates a Lead.
capturedBy, inversecaptures. - A Lead is converted from one Prospect: a Prospect becomes a Lead on first engaging, such as a reply or a Form submission.
convertedFrom, inverseconvertsTo. - A Lead identifies many Visitors: a Lead, once it gives an address, is tied to every Visitor id it used, one per device.
identifies, inverseidentifiedAs. - A Lead is referred by one Referral: each Referral sends one Lead to the Startup.
referredBy, inverserefers. - A Lead waits on one Waitlist: Leads wait on a Waitlist in the order its Setting ranks them.
waitsOn, inverseholds.
Lifecycle
| State | Meaning | Moves to |
|---|---|---|
new (first) | It raised a hand, and no Worker works it yet. | working by Lead.assign; nurture by Lead.nurture; disqualified by Lead.disqualify; converted on Offer.accepted when the Lead buys on its own |
working | Its owner is in touch and owes the next step. | converted by Lead.qualify; converted by Lead.convert; nurture by Lead.nurture; disqualified by Lead.disqualify |
nurture | Not ready to buy: it is off its owner’s queue and hears from a Sequence until it raises a hand again. | working by Lead.assign; disqualified by Lead.disqualify |
converted | It fits an Offer: a Deal is open for it, or it bought on its own; the Customer record carries on. | None: it ends here. |
disqualified | It fits no Offer, for the reason recorded; its Contact record stays. | None: it ends here. |
Verbs
createCreates a Lead.POST /{namespace}/leadsgetReturns one Lead by id.GET /{namespace}/leads/{id}listReturns Leads, newest first, one page at a time.GET /{namespace}/leadsupdateChanges the given properties of a Lead.PATCH /{namespace}/leads/{id}deleteDeletes a Lead; its history is kept.DELETE /{namespace}/leads/{id}assignAssign gives a Lead one owner Worker, by round robin, territory or ICP fit, as the Startup’s routing Policy says.POST /{namespace}/leads/{lead}/assignconvertConvert ends a qualified Lead’s pursuit as a Lead: it opens a Deal or routes the Lead to self-serve checkout.POST /{namespace}/leads/{lead}/convertdisqualifyDisqualify ends a Lead’s pursuit because it fits no Offer, with the reason; its Contact record and Consent stay.POST /{namespace}/leads/{lead}/disqualifynurtureNurture takes a Lead that is not ready to buy off its owner’s queue and onto a Sequence, until it raises a hand again.POST /{namespace}/leads/{lead}/nurturequalifyQualify confirms a Lead matches an Offer’s ICP and opens a Deal for it.POST /{namespace}/leads/{lead}/qualify
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Lead.create | Yes | Yes | Yes | No |
Lead.get | Yes | Yes | Yes | Yes |
Lead.list | Yes | Yes | Yes | Yes |
Lead.update | Yes | Yes | Yes | No |
Lead.delete | Yes | Yes | Yes | No |
Lead.assign | Yes | Yes | Yes | No |
Lead.convert | Yes | Yes | Yes | No |
Lead.disqualify | Yes | Yes | Yes | No |
Lead.nurture | Yes | Yes | Yes | No |
Lead.qualify | Yes | Yes | Yes | No |
Call it
Qualify the latest lead with an offer.Example
A music teacher joins the Waitlist for a lesson-booking App and becomes a Lead, with interest set to "group lessons". She becomes a Customer when she accepts an Offer.