Resolve recipients
Tool ID: email_recipients_resolve
Summary
Checks a list of email addresses against your mailbox rules (format and optional allowed send domains) before you draft or send. It does not send mail.
When to use it
- Before a large send — See which addresses will be accepted or rejected.
- Domain policy — Confirm an address is on an allowed domain.
- Clean a messy list — Normalize names like
Jane Doe <jane@example.com>into clean addresses.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| Email credentials | Yes |
Parameters
| Parameter | Required? | Description |
|---|---|---|
recipients |
Yes | One or more addresses (plain emails or Name <email>). Can be a list or a comma/semicolon-separated string. |
mailbox |
No | Account id (uses that mailbox’s allowlist and limits). Omit for the default. |
What you get back
| Field | Meaning |
|---|---|
accepted |
Addresses that passed the checks |
rejected |
Addresses that failed, each with a reason |
accepted_count, rejected_count |
Totals |
max_recipients_per_send |
Your mailbox’s recipient cap for a real send |
Example prompts
Check whether these addresses are allowed for sending: jane@example.com, bob@other.org, and help@example.com (display name Support).
Validate this customer list against our email allowlist before I draft anything.
Are we allowed to send to someone at gmail.com from the default mailbox?
Tips
- Does not send — Safe to run anytime. Use it when you are unsure about domains or a pasted list.
- Invalid format — Badly formed addresses may fail before they appear in
rejected; ask the AI to fix the format and try again. - Next step — After addresses are accepted, create a draft or send with confirmation.