Skip to content

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

PropertyTypeRequiredDescription
interesttextWhat the Lead asked for.
statusstringrequiredOne of new, working, nurture, converted, or disqualified.
ownerWorkerThe Worker who answers it.
fitstringOne 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
PropertyTypeRequiredDescription
emailemailThe primary email address.
phonestringThe primary phone number.
namestringThe name the Contact goes by.

Object

JSON
{
  "$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

Lifecycle

Lead lifecycle: new, working, nurture, converted (ends), disqualified (ends)new → working: Lead.assignnew → nurture: Lead.nurturenew → disqualified: Lead.disqualifynew → converted: on Offer.acceptedworking → converted: Lead.qualifyworking → converted: Lead.convertworking → nurture: Lead.nurtureworking → disqualified: Lead.disqualifynurture → working: Lead.assignnurture → disqualified: Lead.disqualifynewworkingnurtureconverteddisqualified
StateMeaningMoves 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
workingIts 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
nurtureNot 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
convertedIt fits an Offer: a Deal is open for it, or it bought on its own; the Customer record carries on.None: it ends here.
disqualifiedIt fits no Offer, for the reason recorded; its Contact record stays.None: it ends here.

Verbs

  1. createCreates a Lead.
    POST /{namespace}/leadsdoLead.created
  2. getReturns one Lead by id.
    GET /{namespace}/leads/{id}readNo Event
  3. listReturns Leads, newest first, one page at a time.
    GET /{namespace}/leadsreadNo Event
  4. updateChanges the given properties of a Lead.
    PATCH /{namespace}/leads/{id}doLead.updated
  5. deleteDeletes a Lead; its history is kept.
    DELETE /{namespace}/leads/{id}doLead.deleted
  6. 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}/assigndoLead.assigned
  7. convertConvert 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}/convertdoLead.converted
  8. disqualifyDisqualify ends a Lead’s pursuit because it fits no Offer, with the reason; its Contact record and Consent stay.
    POST /{namespace}/leads/{lead}/disqualifydoLead.disqualified
  9. nurtureNurture 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}/nurturedoLead.nurtured
  10. qualifyQualify confirms a Lead matches an Offer’s ICP and opens a Deal for it.
    POST /{namespace}/leads/{lead}/qualifydoLead.qualified

Permissions

Which Access level may call each Verb. One-way Verbs wait their delay window.

Operationowneradminmemberviewer
Lead.createYesYesYesNo
Lead.getYesYesYesYes
Lead.listYesYesYesYes
Lead.updateYesYesYesNo
Lead.deleteYesYesYesNo
Lead.assignYesYesYesNo
Lead.convertYesYesYesNo
Lead.disqualifyYesYesYesNo
Lead.nurtureYesYesYesNo
Lead.qualifyYesYesYesNo

Call it

Text
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.