send_email · Escouade Mail documentation

Send an e-mail.

Writes a first message to a recipient from an inbox. The message does not leave straight away: it enters the queue and leaves within the space’s sending window (working days, Paris time), within the inbox’s daily quota (warm-up) and with spacing between two sends; or it stays a draft if a human approval is required. Refused if the recipient is blocked (unsubscribed, dead address), if they recently received a first message from this inbox (to follow up: reply_to_thread), or if the inbox is suspended. A one-click unsubscribe link is always added.

Access

Key: an Escouade Mail key with send.
Space: a verified space.
Changes nothing: no, it acts.
Safe to replay: use an idempotency_key where the tool offers one.

Parameters

Parameter	Type	Required	Description
`inbox_id`	string	yes	Sending inbox (inb_…, see list_inboxes).
`to`	string	yes	Recipient’s address.
`to_name`	string	no	Recipient’s name, optional.
`subject`	string	yes	Subject (one line).
`test`	boolean	no	Test send, to yourself only (the space’s human’s e-mail or another inbox of the space): no duplicate rule, and its unsubscribe link unsubscribes nobody.
`from_address`	string	no	The inbox’s main address or an allowed alias (list_inboxes).
`text`	string	yes	Plain text of the message (required). Write {{unsubscribe_url}} to place the unsubscribe link yourself; otherwise Escouade Mail adds a notice in the footer, as long as the correspondent has not written in the thread. No other placeholder in double braces is accepted: replace them beforehand.
`html`	string	no	Optional HTML version, same content as text.
`reply_to`	string	no	Reply-to address, if it differs from the inbox.
`metadata`	object	no	The agent’s free data (8,000 characters at most), returned as it is in reads.
`requires_approval`	boolean	no	true: the message stays a draft until a human approves it (approve_message). Some spaces always require it.
`send_after`	string	no	Not before this date (ISO 8601, or Paris time without a time zone). The window (except for a reply in a conversation) and the quotas apply afterwards.
`idempotency_key`	string	no	Unique key for this send (1 to 255 characters). Replaying the same key with the same content returns the message already created; with different content, an explicit refusal. Recommended for every retry.

Call it

Terminal

curl -s https://api.subagent.fr/v1/send_email \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sak_…' \
  -d '{"inbox_id": "…", "to": "…", "subject": "…", "text": "…"}'

The full page in French, with the response fields and every refusal the tool can return: /mail/docs/reference/send_email.