Write each contact's personal line
argorant_set_lead_custom_fieldsSave the personal lines you wrote for a campaign's contacts, up to 5,000 per call, and add or remove contact tags. Use it after argorant_set_campaign_personalization and argorant_campaign_personalization_status; a finished file of up to 200,000 rows goes through the API or the command line instead, followed with argorant_personalization_import_status. Only the campaign's own variables are accepted. Write each line only from facts you looked up for that contact and never invent a detail, number, customer or claim; when the facts do not tell you, send keep_fallback: true. Before the first save, show the user 5 example lines inside their sentences and wait for a yes. Each line is plain text on one line, within the variable's max_length, with no links unless the campaign allows them. A saved line is never replaced unless overwrite is true; without it, a contact that has a line keeps it and is listed in kept_existing. The answer counts what was saved, refused with the reason, not found and still to write, and lists every replaced or cleared line in changes. Tags need no personalization setup; afterwards the remove, restore, move and list tools for campaign people can select by tag. More in the docs at https://docs.argorant.com/docs/agents/tools#campaigns
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"campaign_id": "<campaign_id>",
"leads": "<leads>"
},
"name": "argorant_set_lead_custom_fields"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| leads | Yes | 1 to 5,000 contacts, as [{lead_id or email, values?, keep_fallback?, basis?, tags?, untag?}]. values maps each custom_ variable to its line, or to null with overwrite true to clear it. keep_fallback true keeps the fallback for a contact with no usable facts and takes them off the list; false puts them back on it. basis says in a few words where the fact came from, up to 200 characters. tags (a list, or tag as one text) and untag add and remove contact tags, saved in lower case; an entry with only tags needs no values. | |
| overwrite | No | true replaces or clears lines the contacts already have. Leave it false (default) so saved lines are never replaced by accident. | |
| campaign_id | Yes | The campaign's id, from argorant_list_campaigns. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |