Find email
find_emailCosts 1 Sliq credit per verified email; a BYO-Apollo key makes the Apollo
leg free. The default chain runs MoltSets first and fills its misses with
Apollo, so a contact that comes back {'error': ...} has been tried by both
providers and is final — report those gaps and move on rather than
re-running them.
When only one provider ran — a BYO-Apollo user's default, or an explicit 'apollo' pin — the other is still untried, and the result says so. That paid lookup is the user's call: in a background run with no one to answer, report how many were missed and stop; in an interactive chat, tell them the count and offer a MoltSets backfill (1 credit/hit), re-calling with provider='moltsets' on just those contacts only after they say yes.
A contact this user already resolved in the last 24h is served from a cache,
so re-calling does not look up or charge again.
One entry per input contact, in input order — either a hit dict
(email, email_status, name, title, linkedin_url) or an
{'error': ...} miss — followed by any warnings. A hit's linkedin_url is the
person's LinkedIn profile URL; a recipient or person takes it as linkedin_slug.
Each verified email is also written for you onto the person's canonical
profile if it had none, which is the address every campaign tracking that
person sends to and the one the Email column on the Output tab shows
wherever they're on a list — you do not match or persist emails back onto
rows yourself. It adds no one to an agent's list: when a person found here
who isn't on it yet belongs there, record them with record_search_results.
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": {
"contacts": "<contacts>"
},
"name": "find_email"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| contacts | Yes | People to look up. Each needs a name, plus either an apollo_id or at least one of linkedin_slug, company_name, or company_domain. | |
| provider | No | Leave unset (default) to let the chain pick — almost always right; don't pin a source the user didn't ask for. Set 'apollo' or 'moltsets' to pin a single source: 'apollo' runs Apollo alone (free with BYO Apollo, 1 credit/hit on Sliq's key); 'moltsets' runs MoltSets alone (1 credit per hit). Use 'moltsets' for the backfill the user approved after a run where only Apollo went out. Pinning skips the fallback, so coverage may be lower. | |
| on_behalf_of | No | A teammate's email, or an agency client's from list_agency_clients, to run this call in that account: their agents, settings, connected accounts, and credits. Omit it to act on your own account. |