For the complete documentation index, see llms.txt. This page is also available as Markdown.

Lead

Every built-in field on the Spara Lead object, organized by category, with the API name for each.

A Lead is a single person on the buying side — the center of Spara's data model. This page catalogs every built-in Lead field. For how the Lead relates to the other objects, see Spara Objects & Fields.

Every field has an API name — the snake_case identifier in the tables below. Use the API name when referencing a field programmatically:

  • Personalization templates{{ first_name }} in agent instructions, emails, and text messages. See Guide: How to Use Spara's Text Editor.

  • Workflow conditions — comparing field values in Condition steps.

  • API requests and responses — lead fields in the Web API and Javascript API.

  • Webhook payloads — field values delivered by Webhooks.

Custom fields your team defines appear in your instance alongside these built-ins; the Data Model page shows each one's API name.

Fields from the lead's linked Account and Owner are also available on the lead, prefixed with lead_account_ and lead_owner_ — see Account and Owner for those.

Lead Info

Field
API name
Type
Description

First name

first_name

String

Lead's first name

Last name

last_name

String

Lead's last name

Full name

full_name

String

First and last name combined; falls back to the best identity available for the lead

Email

email

String

Lead's email address

Phone number

phone_number

String

Lead's phone number

Job title

job_title

String

Lead's job title or role

Lead source

lead_source

Picklist

How this lead was created in Spara. Spara — created via Chat or Voice agents Salesforce — synced from Salesforce CRM HubSpot — synced from HubSpot CRM Marketo — synced from Marketo CRM Leads API — created via the Leads API Deanonymized — identified via IP/behavioral matching

Lead stage

lead_stage

Picklist

Current stage in the sales funnel, calculated from lead activity. Browsing — visiting pages but hasn't engaged Engaged — has sent at least one message or made a call Email Captured — email address has been collected Webform Submitted — submitted a webform Calendar Shown — was shown a scheduling calendar Meeting Scheduled — has a meeting scheduled Synced from CRM — imported from CRM with no local activity

Note: CRM field mappings continue to receive the value Call scheduled for this stage, so existing CRM picklists and automations are unaffected.

Lead created at

lead_created_at

Timestamp

Timestamp when the lead was first created

Lead URL (Spara)

lead_url

String

URL to the lead's profile page in the Spara platform

Conversation summary

conversation_summary

String

AI-generated summary of the lead's conversation history

Conversation interests

conversation_interests

String

Lead's interests identified from conversations

Conversation pain points

conversation_pain_points

String

Pain points identified from conversations

Most recent call summary

most_recent_call_summary

String

Summary of the most recently completed voice call

Organization name

org_name

String

Your organization's name

Sales rep name

sales_rep_name

String

Display name of the sales rep persona your agents speak as

Account Info

These fields describe the lead's company as captured on the Lead itself. Fields from the linked Account object are separately available — see Account.

Field
API name
Type
Description

Company name

company_name

String

Name of the lead's company

Employee count

num_employees

Integer

Number of employees at the lead's company

Website Activity

Field
API name
Type
Description

Current URL

current_url

String

Page the lead is currently viewing

Initial URL

initial_url

String

First page visited by the lead

Last page visited

last_webpage_visited

String

Most recently visited page URL

Pages visited

webpages_visited

List

List of unique URLs visited, most recent first

Website visited at

website_visited_at

Timestamp

Timestamp of the lead's most recent page visit

Referrer

referrer

String

External site or page the lead came from

IP country

ip_country

String

2-letter country code from the lead's IP address

IP country name

ip_country_name

String

Full country name from the lead's IP address

IP region

ip_region

String

State or region from the lead's IP address

IP city

ip_city

String

Approximate city from the lead's IP address

Timezone

timezone

String

IANA timezone of the lead (e.g. America/New_York)

Chat Activity

Field
API name
Type
Description

Conversation started at

conversation_started_at

Timestamp

Timestamp when the lead first started a chat

Opened chat

opened_chat

Boolean

Whether the lead has opened the chat widget

Sent chat message

sent_chat_message

Boolean

Whether the lead has sent at least one message

Chat dropoff at

chat_dropoff_at

Timestamp

Timestamp when the lead last engaged in chat

Prospect message count

prospect_message_count

Integer

Total chat messages sent by the lead

Organization message count

organization_message_count

Integer

Total chat messages the agent has sent to the lead

Engaged channels

engaged_channels

String

Which Spara channels the lead has interacted with (Chat, Phone, Product Demo, Email, Text)

Email Activity

Field
API name
Type
Description

Email opened at

email_opened_at

Timestamp

Timestamp when the lead opened an email

Email link clicked at

email_link_clicked_at

Timestamp

Timestamp when the lead clicked a link in an email

Last email sent at

last_email_sent_at

Timestamp

Timestamp of the most recent email sent to the lead

Last email agent sent at

last_email_agent_sent_to_lead_at

Timestamp

Timestamp when the last email was sent from the agent to the lead

Last email lead sent at

last_email_lead_sent_to_agent_at

Timestamp

Timestamp when the last email was sent from the lead to the agent

Lead replied to email agent

has_lead_replied_to_email_agent

Boolean

True if the lead replied to any email sent by a workflow

Email validation status

email_validation_status

Picklist

Result of email address validation. Valid — address is deliverable Invalid — address is not deliverable Unknown — not yet validated

Email unsubscribed

email_unsubscribed

Boolean

Whether the lead's email address has unsubscribed from emails

Unsubscribed at

unsubscribed_at

Timestamp

Timestamp when the email address unsubscribed. The opt-out belongs to the address, so it shows on every Lead sharing that address

Email opened at and Email link clicked at stay empty if your organization has turned off Email Tracking under Settings → Email Configuration.

Phone & Text Activity

Field
API name
Type
Description

Most recent outgoing call — cold transferred

most_recent_outgoing_call_cold_transferred

Boolean

Whether the call was cold transferred to a rep

Most recent outgoing call — warm transferred

most_recent_outgoing_call_warm_transferred

Boolean

Whether the call was warm transferred to a rep

Most recent outgoing call — booked call

most_recent_outgoing_call_booked_call

Boolean

Whether the call resulted in a booked meeting

Most recent outgoing call — left message

most_recent_outgoing_call_left_message

Boolean

Whether a voicemail was left

Most recent outgoing call — do not call

most_recent_outgoing_call_do_not_call

Boolean

Whether the lead requested not to be called

Most recent outgoing call — no answer

most_recent_outgoing_call_no_answer

Boolean

Whether the call went unanswered

Call pick up

call_pick_up

Boolean

Whether the lead answered the most recent call

Lead answered call from voice agent

has_lead_answered_call_from_voice_agent

Boolean

True if the lead answered any call made by a workflow

Lead replied to text agent

has_lead_replied_to_text_agent

Boolean

True if the lead replied to any text sent by a workflow

Incoming call ended at

incoming_call_ended_at

Timestamp

Timestamp when the last incoming call ended

Outgoing call ended at

outgoing_call_ended_at

Timestamp

Timestamp when the last outgoing call ended

Do Not Call

do_not_call

Boolean

Whether the lead's phone number is on the do-not-call list

Do Not Text

do_not_text

Boolean

Whether the lead's phone number is on the do-not-text list

Meeting Activity

Field
API name
Type
Description

Meeting scheduled

call_scheduled

Boolean

Whether a meeting has been scheduled

Meeting scheduled at

call_scheduled_at

Timestamp

Timestamp of the upcoming scheduled meeting

Calendar shown

call_calendar_shown

Boolean

Whether a calendar has been shown to the lead

ChiliPiper assignee

chilipiper_assignee_id

String

ChiliPiper assignee ID from the booking confirmation

Sign Up Info

Field
API name
Type
Description

Webform submitted

webform_submitted

Boolean

Whether the lead has submitted a webform

Spara Questions

Field
API name
Type
Description

Call interest

call_interest

Picklist

Type of conversation the lead expressed interest in. Talk to sales — wants to speak with a sales rep Talk to support — has a support or technical issue Product demo — interested in seeing a product demo Unspecified — expressed intent to talk but type is unclear

Support interest

support_interest

Boolean

Whether the lead has a support issue

These are default fields. Any question your agent asks can create additional custom fields in this category.

Advertising & Tracking

Field
API name
Type
Description

UTM campaign

utm_campaign

String

UTM campaign parameter from the lead's URL

UTM source

utm_source

String

UTM source parameter from the lead's URL

UTM medium

utm_medium

String

UTM medium parameter from the lead's URL

UTM term

utm_term

String

UTM term parameter from the lead's URL

UTM content

utm_content

String

UTM content parameter from the lead's URL

GCLID

gclid

String

Google Click Identifier for Google Ads attribution

GCL AW

gcl_aw

String

Google Ads attribution cookie value (_gcl_aw)

GCL AU

gcl_au

String

Google Click Linker cookie value (_gcl_au)

Time & Date

Field
API name
Type
Description

Current time (UTC hour)

current_time_utc_hour

Integer

Current hour in UTC

Current time (UTC minute)

current_time_utc_minute

Integer

Current minute in UTC

Current time (UTC weekday)

current_time_utc_weekday

Integer

Current day of the week in UTC

Current timestamp (UTC)

current_timestamp_utc

Timestamp

Full current timestamp in UTC

Deanonymization Fields

Populated by Deanonymization when a visitor is identified. These fields are read-only and deliberately namespaced with a deanonymized_ prefix: a vendor's identity guess is kept separate from the primary identity fields (email, first_name, company_name, …), so it never overwrites data the lead provided or your CRM synced. See Trust Hierarchy.

Field
API name
Type
Description

Deanonymized company name

deanonymized_company_name

String

Company name resolved by the deanonymization provider

Deanonymized company domain

deanonymized_company_domain

String

Company domain resolved by the provider

Deanonymized company LinkedIn URL

deanonymized_company_linkedin_url

String

Company LinkedIn page URL

Deanonymized company size

deanonymized_company_size

String

Company-size bucket label, e.g. "Large (1,000 - 4,999 Employees)"

Deanonymized industry

deanonymized_industry

String

Industry-taxonomy label, e.g. "Software > Security"

Deanonymized company revenue

deanonymized_revenue

String

Company-revenue bucket label, e.g. "Large ($100MM-$200MM)"

Deanonymized email

deanonymized_email

String

Email resolved by the provider (business email when available)

Deanonymized first name

deanonymized_first_name

String

First name resolved by the provider

Deanonymized last name

deanonymized_last_name

String

Last name resolved by the provider

Deanonymized job title

deanonymized_title

String

Job title resolved by the provider

Deanonymized department

deanonymized_department

String

Department resolved by the provider

Deanonymized seniority

deanonymized_seniority

String

Seniority bucket label, e.g. "Csuite", "Management"

Deanonymized professional group

deanonymized_professional_group

String

Professional-group label, e.g. "IT Professional"

Deanonymized LinkedIn URL

deanonymized_linkedin_url

String

LinkedIn profile URL resolved by the provider

Deanonymized first visit at

deanonymized_first_visit_at

Timestamp

When the provider first saw this visitor on the site

Deanonymized last visit at

deanonymized_last_visit_at

Timestamp

When the provider most recently saw this visitor on the site

Deanonymized unique pages visited

deanonymized_unique_pages_visited

Integer

How many distinct pages the provider has seen this visitor view

CRM Fields

Any field synced from Salesforce, HubSpot, or Marketo appears alongside the built-in fields, with the API name shown on the Data Model page. A few CRM-related built-ins:

Field
API name
Type
Description

Salesforce URL

salesforce_record_url

String

URL to the lead's Salesforce record

HubSpot URL

hubspot_record_url

String

URL to the lead's HubSpot contact record

Is primary contact

is_primary_contact

Boolean

Whether this lead is the primary contact on their CRM account

Salesforce Lead ID

salesforce_lead_id

String

ID of the lead's Salesforce Lead record, once synced

Salesforce Contact ID

salesforce_contact_id

String

ID of the lead's Salesforce Contact record, once synced

HubSpot Contact ID

hubspot_contact_id

String

ID of the lead's HubSpot Contact record, once synced

Marketo Lead ID

marketo_lead_id

Integer

ID of the lead's Marketo Lead record, once synced

See CRM integrations for setup instructions.

Workflow Fields

A few additional read-only fields — such as whether the lead replied to an email sent by the current workflow, or how many times they opened its emails — exist only in the context of a running workflow. They appear in the workflow editor's field pickers where they apply.

Last updated