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
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
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.
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
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
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
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
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
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
Webform submitted
webform_submitted
Boolean
Whether the lead has submitted a webform
Spara Questions
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
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
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.
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:
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