Get a lead

One lead with its contacts, the surfaced draft, and the research behind each column.

Requires the leads:read scope.

Response. { "lead": { …, fields, draft, research, contacts: [contact, …], contactsTruncated: false } }. Contacts are capped at 50, with contactsTruncated: true when there were more. The lead and each contact carry workflowRunId, the workflow run that created it, or null. 404 for an unknown or another account's lead.

A contact is { id, workflowRunId, email, name, firstName, title, linkedinUrl, photoUrl, emailStatus, role, isPrimary, identityConfidence }, with null for anything not known.

draft is the surfaced draft, { subject, body } (each cut at 16,000 characters), or null when there is none. research is a list of entries, one per key the agent saved research under: { key, reasoning, sources: [{ url, title }], sourcesTruncated }, the agent's reasoning (cut at 8,000 characters) and up to 20 sources behind that value. A source whose URL is longer than 2,048 characters is left out rather than cut, and sourcesTruncated says when anything was left out. Keys with no visible column appear here too.