ToolsSearch & Enrichment
Write data points
Write the values YOU researched for a group's custom (agent-owned) columns - the server stores them per (group, lead).
Tool: write_data_points
Provider-filled columns are rejected here (the server owns those). For each lead record status='done' with a value, 'not_found' if nothing exists, or 'error' with a short reason. Values must be compact - never raw web/tool output.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
lead_group_id | string (slug or UUID) | yes | The group whose members to write. |
values | object | yes | Map of lead id → {field_key: cell}, cell = {value?, status, reason?, evidence?}. Only agent-owned (custom) declared keys are accepted; provider-filled columns are rejected. |
For the custom columns you research yourself;
statusisdone(needs a value),not_found, orerror(needs a reason).Provider-filled columns are server-owned and rejected here. Values must be compact - never raw web/tool output.
Custom columns are declared with
add_data_points({key, instruction, type}).
Sample request — success
{
"lead_group_id": "ceo-prospects-0010",
"values": {
"dana-white-0015": {
"recent_funding": {
"value": "Series B, $30M (2026-05)",
"status": "done",
"evidence": [
{
"url": "https://techcrunch.com/x",
"snippet": "raised $30M Series B"
}
]
}
}
}
}Sample request — not found
{
"lead_group_id": "ceo-prospects-0010",
"values": {
"dana-white-0015": {
"recent_funding": {
"status": "not_found"
}
}
}
}