Send a message

POSThttps://myagentmail.com/v1/inboxes/{id}/send

Sends from this inbox. The From header is derived from the inbox's primary alias. Pass verified: true when you've validated the recipient domain out-of-band (e.g. via verify-email); otherwise, sends to an address that has never replied to this inbox are rejected as a deliverability safeguard.

Path parameters

id

required

string

Inbox UUID

Request body

Content-Type: application/json

`to` required string \| string[]
`subject` required string
`plainBody` string
`htmlBody` string
`replyTo` string	format: email
`verified` boolean	default: false

Responses

200application/jsonSent

`id` string	format: uuid
`threadId` string	format: uuid
`status` string
`messageId` string

403Inbox paused or plan limit reached

502SMTP relay error

Authentication

Send your API key in the X-API-Key header (or Authorization: Bearer <key>). Any prefix accepted by this endpoint — tk_, wk_, ak_, or sa_ — is documented in the key prefix table.

Request

import { MyAgentMail } from "myagentmail";

const client = new MyAgentMail({ apiKey: process.env.MYAGENTMAIL_API_KEY! });

// POST /v1/inboxes/{id}/send
const result = await client.request("post", "/v1/inboxes/{id}/send", { params: { id: "00000000-0000-0000-0000-000000000000" } }, { body: {
  "subject": "string",
  "plainBody": "string",
  "htmlBody": "string",
  "replyTo": "[email protected]",
  "verified": false
} });

Example response · 200

{
  "id": "00000000-0000-0000-0000-000000000000",
  "threadId": "00000000-0000-0000-0000-000000000000",
  "status": "sent",
  "messageId": "string"
}