append_batch_emails
Append a chunk of emails (up to 4096) to a batch created by submit_batch with final set to false, so a list can grow past the single-call cap. Use it only for a batch whose intake is still open; to start a batch use submit_batch. It reserves and queues the chunk exactly like submit_batch and runs the check set the batch was submitted with: omit checks on every chunk (naming another set is refused with append_batch_emails.checks_mismatch). Set final to true on the last chunk (an empty emails list is allowed) to close intake; the batch then completes once every job finishes. A final chunk that would leave the batch under 20 distinct valid addresses is refused and the batch stays open. Requires the email:verify:bulk scope.
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": {
"batch_uuid": "<batch_uuid>",
"emails": "<emails>"
},
"name": "append_batch_emails"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| final | No | Whether this is the batch's final chunk (defaults to true). Set false to keep intake open for a further append_batch_emails call. | |
| checks | No | Optional check wire strings (syntax, mx, smtp, disposable, role, free, catchall). Omit them: the chunk then runs, and is billed for, the check set the batch was submitted with. Naming a different set is refused (append_batch_emails.checks_mismatch); naming the same one is accepted. | |
| emails | Yes | Email addresses to verify in this chunk (up to 4096). May be empty to close intake without adding more emails. A final chunk is refused when the batch would close with fewer than batch_min (20) distinct valid addresses; the batch then stays open. | |
| batch_uuid | Yes | Public batch UUID of an open batch (created by submit_batch with final: false). | |
| custom_ids | No | Optional per-email client references, index-aligned 1:1 with emails. Echoed back verbatim in get_batch_results so you can map each result to your input row. Do not put the email address or any PII here, use your own row identifier (e.g. a CRM id). |