Look up contacts by email
plunk_lookup_contactsResolve up to 500 email addresses to contacts in one call. Read-only lookup returns matching contact IDs, subscription states, and unmatched addresses.
Instructions
Purpose: Resolve up to 500 email addresses to contacts in one call. Reads only; nothing is created.
Not for: Browsing or searching by partial address, which is plunk_list_contacts.
Returns: The matching contacts, and which addresses had no match.
Use when: You hold a list of addresses and need their ids or subscription states — far better than one lookup per address.
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": {
"emails": "<emails>"
},
"name": "plunk_lookup_contacts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| emails | Yes | Up to 500 emails to look up at once |