Skip to content

Mail

Sends mail with your own credentials, from templates kept per workspace. Agents and workflows reach it through its tools; every send is logged.

The page in the app: Mail.

  • workspace_id - where templates and the log live;
  • from (address and name), optional reply_to;
  • transport: smtp (host, port, security, user, password), resend (API key) or postmark (server token, stream). SES works over its SMTP interface;
  • allow - the recipients it may send to (an address or @domain; empty: any) - narrow whom an agent can mail;
  • daily_limit - messages a day (default 200).

Secrets (passwords, keys) are write-only; the panel only shows they are set.

A template declares its inputs (name, type, description, example) and three parts - subject, HTML body, text body - with {{ expression }} parts filled from the values at send. Checked on save (every expression parsed and type-checked), values checked on send; HTML is escaped.

Tool What
mail_send to/cc/bcc (at least one to, at most 50), a template with values or a raw subject and body
mail_test a fixed test message to one address (person, from the panel)
mail_templates_list / get / save / preview the templates, checked and previewed
mail_log the log, newest first

Sending is an external action: the team’s trust decides whether it waits for a person. A recipient outside allow or past the daily limit is refused before anything is sent, and the refusal is logged. The log keeps 90 days; bodies and values are not kept.