Mail

Send a composed message from one of your aliases.

REST mirror of the MCP mail_send tool. Requires send scope. The From: is locked to one of the caller's active @inboxy.net aliases (forced to the bound alias on address-scoped keys). Recipients are classified internal vs external; external sends enqueue onto outbound-send and carry the inboxy attribution footer. Plan-tier daily caps + per-user rate limits apply.

post/v1/mail/send

Request

  • Base URL: https://api.inboxy.net
  • URL: https://api.inboxy.net/v1/mail/send
  • Auth: HTTP bearer

Request body

from_local_partstring required

Local-part of the alias to send from. Must be one of the caller's active aliases. When the API key is address-scoped this is forced to the bound alias and key_scope_mismatch is returned on conflict.

tostring required

RFC 5322 recipient address. Mailbox-syntax validated server-side.

subjectstring required

Trimmed and truncated at 200 chars.

textstring

Plain-text body. Required if html is absent.

htmlstring

Optional HTML body.

in_reply_tostring

Optional Message-Id to thread against. Sanitized server-side before being written to headers.

Response

Accepted — internal delivery completed, external queued.

oktrue required
delivery'internal' | 'external' required

internal = recipient is another inboxy user; delivered directly. external = enqueued onto outbound-send for the sender worker.

message_idstring uuid

Present on internal delivery only — the recipient's new messages.id.

fromstring email required
tostring email required
subjectstring required
idempotency_keystring required

Changes

No recorded changes to this operation across all 1 revision of this API.