Market pillar · v0.16.0

lead Lead

Lead record.

$id · https://corpospec.com/schemas/v0.16.0/lead.schema.json

Fields

Field Type Required Description
contact_pseudonym string yes Pseudonymised contact handle (hash of email / phone).
created_at IsoDate yes ISO 8601 date (YYYY-MM-DD).
entity PathRef yes Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
id PathRef yes Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
lawful_basis string yes Lawful basis for processing (Art. 6 GDPR — required for any EU subject).
owner_sdr PathRef yes Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pii_class PiiClass yes Personal-data classification on every record carrying personal data, per BDR 0070 / BDR 0069 / BDR 0078. Used by `corpospec-report` to gate rendering and by the privacy pillar's RoPA records to determine safeguards.
qualification_framework QualificationFramework yes Qualification framework + score (0-100).
source LeadSource yes Lead source.
stage LeadStage yes Lifecycle stage (Forrester demand-waterfall).
company_name string? Company name (free-form until linked to a Customer).
consent_ref PathRef? PathRef to consent record (if Art. 6(1)(a) is the basis).
converted_opportunity PathRef? Set when stage == Converted.
disqualification_reason DisqualificationReason? Set when stage == Disqualified.
job_title string? Job title (when known).
last_contacted_at IsoDate?
lia_ref PathRef? PathRef to LIA artefact (if Art. 6(1)(f) is the basis).
qualification_score number?
source_campaign PathRef? Campaign that generated the lead (PathRef into campaign.rs).

Definitions

Shared types referenced within this schema.

DisqualificationReason
Disqualification reason.
IsoDate
ISO 8601 date (YYYY-MM-DD).
type: string
LeadSource
Lead source.
LeadStage
Lifecycle stage (Forrester demand-waterfall).
PathRef
Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$
PiiClass
Personal-data classification on every record carrying personal data, per BDR 0070 / BDR 0069 / BDR 0078. Used by `corpospec-report` to gate rendering and by the privacy pillar's RoPA records to determine safeguards.
QualificationFramework
Qualification framework.

Reference in your YAML

# yaml-language-server: $schema=https://corpospec.com/schemas/v0.16.0/lead.schema.json