All tools

Email · send_email

Send an email

Send one or many emails from the connected business address.

Price
included
Requirements
Gmail or Outlook or Resend
set it up in Settings → Integrations
Human approval
Yes, by default
outside-facing write: a human validates
Reliability
Verified
stable · 0.3 s

Input

FieldTypeDescription
emailsarrayBatch send: the FULL list of emails to send in one call (preferred whenever there is more than one). Each item takes the same fields as a single email. When provided, the top-level single-email fields are ignored.
prospectingbooleanREQUIRED true for every cold first contact or cold follow-up to a prospect (J0, J+3, J+7…). The whole batch is then checked before anything leaves: plain text, one link at most, 1 500 characters at most, one recipient per message, a subject that names the recipient's own company, an opt-out line (« Pour ne plus être contacté : répondez « stop ». ») and, unless aiDisclosure is false, an AI-agent disclosure in the signature. A non-compliant batch is refused with the list of problems: fix them and resend the full batch. Replies to a prospect who answered are not prospecting.
aiDisclosurebooleanWith prospecting: whether the body must disclose that the sender is an AI agent (default true; set false only when the workspace rules say the agent writes in a human's name).
schedulenow | spread"spread" (default for a prospecting batch of two or more): the messages are placed in the outbox and leave one by one during business hours in Paris; "now": immediate send (replies, single urgent messages).
prospectIdstringSingle e-mail: prospect id to mark contacted at the real send.
intentstringType of the customer request this message answers, one of: info_produit, conseil, livraison, garantie, retour, reparabilite, reclamation, facturation, autre. Always pass it on a support reply: the workspace approval rules can depend on it, and the SAV report counts by type.
anglestringSingle e-mail: short label of the message angle.
allowRecontactbooleanOnly when the USER decided it: send a new first e-mail to a company contacted less than 14 days ago without reply. Otherwise such messages are refused (follow up in the thread with reply_email instead).
to *arrayRecipient email addresses
subject *stringEmail subject line
body *stringEmail body in plain text or HTML
ccarrayCC email addresses (optional)
fromstringSender email address — must match a configured provider (Gmail/Outlook/Resend). The tool selects the provider whose address matches. If both Gmail and Resend match, Gmail is preferred. Omit to use the first available provider.
inReplyTostringRFC 2822 Message-ID of the email to reply to — enables email threading for outreach follow-ups. Use the messageId returned by a previous send_email call.
replyTostringReply-To address — where recipient replies should land. Omit unless the user asked for a specific one: the workspace default (Settings → Integrations → Resend) already routes replies to the address the agent can read.

Call this tool

Through the HTTP API, or from the MCP server with the run meta-tool.

curl https://api.ezyagents.fr/gateway/v1/run \
  -H "Authorization: Bearer ezk_…" -H "Content-Type: application/json" \
  -d '{"tool":"send_email","input":{"emails":[],"prospecting":true,"aiDisclosure":true,"schedule":"now"}}'
$run({ "tool": "send_email", "input": {"emails":[],"prospecting":true,"aiDisclosure":true,"schedule":"now"} })