LinkedIn Leads

What it is

The working record for one LinkedIn contact — a lightweight CRM row that your outreach agents create and keep up to date. It carries who the person is (identity), where they sit in the pipeline (status, score, segment), the timeline of every outreach touch, which agent last acted and which acts next, and the sync keys that tie the row back to LinkedIn, Unipile, and Attio. One row per person. New leads are typically discovered from comments on relevant LinkedIn posts, scored, then moved through connect → contact → follow-up → close by the agents that own the pipeline.

How it gets data

Populated by outreach/marketing agents and connectors (Unipile for LinkedIn); not part of the standard onboarding catalog. Available to query once your workspace runs the relevant agents.

Rows are de-duplicated on external_id — the LinkedIn member URN for connection-based leads, or the chat id for message-based ones. Agents upsert on that key, so re-processing the same person updates the lead instead of creating a duplicate.

Fields

Identity

Field	Type	Description
`full_name`	text	Lead’s full name
`first_name`	text	First name (used to personalize messages)
`headline`	text	LinkedIn headline / tagline
`job_title`	text	Job title
`profile_url`	text	Link to the LinkedIn profile
`public_identifier`	text	LinkedIn public profile handle
`linkedin_member_urn`	text	LinkedIn member URN — the stable member id
`location`	text	Free-text location
`country_code`	text	ISO country code
`target_name`	text	The account/brand this lead is associated with, when targeted

Pipeline & scoring

Field	Type	Description
`status`	text	Pipeline stage (e.g. new, connected, contacted, replied, closed)
`source`	text	Where the lead came from (e.g. a post, a search, an import)
`segment`	text	Segment the lead was bucketed into
`lead_score`	integer	Fit/priority score assigned by the scoring agent
`priority_flag`	text	Priority marker for the working queue
`role_category`	text	Normalized role bucket (e.g. founder, marketing, buyer)
`contact_type`	text	Type of contact (e.g. prospect, partner, influencer)
`outreach_channel`	text	Channel chosen for outreach
`notes`	text	Free-text notes on the lead
`department_id`	uuid	Owning department, for visibility scoping

Outreach timing

Field	Type	Description
`connection_sent_at`	datetime	When the connection request was sent
`connected_at`	datetime	When the connection was accepted
`contacted_at`	datetime	First outreach message time
`last_contacted_at`	datetime	Most recent outreach time
`next_follow_up_at`	datetime	When the next follow-up is due
`next_action_at`	datetime	When the next scheduled action fires
`next_action_reason`	text	Why that next action is queued
`follow_up_count`	integer	How many follow-ups have been sent
`closed_at`	datetime	When the lead was closed
`closed_reason`	text	Why the lead was closed (won, lost, no-fit, …)
`chat_id`	text	LinkedIn conversation id, once a chat exists
`last_message_text`	text	Text of the most recent message in the thread
`last_message_at`	datetime	Time of the most recent message

Agent handoff

Field	Type	Description
`agent_source`	text	Which agent originally created the lead
`last_agent`	text	Agent that last acted on the lead
`last_agent_at`	datetime	When that agent acted
`last_agent_action`	text	What that agent did
`next_agent`	text	Which agent is expected to act next

Sync & source

Field	Type	Description
`attio_contact_id`	text	Linked Attio contact id, when synced to the CRM
`attio_synced_at`	datetime	Last Attio sync time
`unipile_invitation_id`	text	Unipile invitation id for the connection request
`source_author`	text	Author of the post/comment the lead was found on
`source_comment_text`	text	The comment text the lead was sourced from
`external_id`	text	Dedup key — member URN for connection leads, chat id for message leads

Like every workspace table, LinkedIn Leads also carries the system columns id, tenant_id, workspace_id (tenant isolation), created_at, and updated_at. They are managed automatically.

Query it

{
  "method": "tools/call",
  "params": {
    "name": "data_query",
    "arguments": {
      "view_slug": "linkedin_leads",
      "filters": { "status": "connected" },
      "select_fields": ["full_name", "headline", "lead_score", "next_follow_up_at", "last_agent"],
      "sort_by": "lead_score",
      "limit": 50
    }
  }
}

Getting Started

Resources

Sales & Commerce

Procurement

Marketing & Outreach

Governance

What it is

How it gets data

Fields

Identity

Pipeline & scoring

Outreach timing

Agent handoff

Sync & source

Query it

​What it is

​How it gets data

​Fields

​Identity

​Pipeline & scoring

​Outreach timing

​Agent handoff

​Sync & source

​Query it

What it is

How it gets data

Fields

Identity

Pipeline & scoring

Outreach timing

Agent handoff

Sync & source

Query it