Enrich a person
enrich_personUse this when the user wants one person's work email address, phone number or both. Name the person one way: by personId, by linkedinUrl, or by a name with companyName or companyDomain. find says what to look for (an email by default); providers says where: package (the default) searches our own data, and waterfall goes on to further providers, which can take over a minute. The person is saved in the workspace with what was found. Charged per value found: an email $0.02 from the package or $0.05 from the waterfall, a phone number $0.05 or $0.10. Values a person already had are free. A search that finds nothing is free. Personal email addresses are never returned or charged.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "enrich_person"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| find | No | What to find: a work `email` (the default), a `phone` number, or both (`email_and_phone`). | |
| fullName | No | The person's full name, in place of `firstName` and `lastName`, with `companyName` or `companyDomain`. | |
| lastName | No | The person's last name, with `companyName` or `companyDomain`. | |
| personId | No | The person's id: the `id` of their row on a list, or the id an earlier enrichment or upload answered. Send it on its own. | |
| firstName | No | The person's first name, with `companyName` or `companyDomain`. | |
| providers | No | Where to look: `package` (the default) searches our own data package; `waterfall` searches the package, then a fixed series of further providers. A value's price depends on who found it. | package |
| companyName | No | The name of the company the person works at. | |
| linkedinUrl | No | The person's LinkedIn profile URL. Send it on its own. | |
| companyDomain | No | The website domain of the company the person works at, such as `northwind.example`. |