ToolsSearch & Enrichment

Add data points

Add a column of data to a lead group's members.

Tool: add_data_points

Provider facts - funding, revenue, web traffic, headcount, hiring, seniority, skills - fill in automatically (the server fetches them, so you don't research these by hand); pass their keys. For facts no provider covers, declare a custom column as {key, instruction, type} and fill it with write_data_points. Provider columns cost credits; poll get_lead_group for per-column progress. Omit data_points to fill existing columns for newly-added leads.

Parameters

ParamTypeRequiredDescription
lead_group_idstring (slug or UUID)yesThe group to add enrichment columns to.
data_pointsarraynoProvider keys (strings, e.g. funding, web_traffic, seniority) that the server fetches and fills in the background, and/or custom columns {key (snake_case), instruction, type, options?} you fill yourself. Omit to (re)fill the group's existing columns for new leads.
lead_idsarraynoFill only these lead ids; omit for every member.

Provider data points fill in the background - poll get_lead_group for each column's status. Custom columns you fill with write_data_points.

Provider points cost credits; the response returns an est_credits upper bound before the fill runs.

A company point may only be added to a company group, a person point to a people group.

Sample request — custom

{
  "lead_group_id": "ceo-prospects-0010",
  "data_points": [
    {
      "key": "recent_funding",
      "label": "Recent funding",
      "instruction": "most recent funding round, from the web",
      "type": "text"
    }
  ]
}

Sample request — success

{
  "lead_group_id": "ceo-prospects-0010",
  "data_points": [
    "skills"
  ]
}

On this page