Create a draft

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

Path parameters

id

required

string

Inbox UUID

Request body

Content-Type: application/json

`to` string \| string[]
`cc` string \| string[]
`bcc` string \| string[]
`subject` string
`plainBody` string
`htmlBody` string
`replyToMessageId` string	format: uuid

Responses

201application/jsonCreated

`id` string	format: uuid
`inboxId` string	format: uuid
`to` string[]
`cc` string[]
`bcc` string[]
`subject` string
`plainBody` string
`htmlBody` string
`replyToMessageId` string	format: uuid
`createdAt` string	format: date-time
`updatedAt` string	format: date-time

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}/drafts
const result = await client.request("post", "/v1/inboxes/{id}/drafts", { params: { id: "00000000-0000-0000-0000-000000000000" } }, { body: {
  "subject": "string",
  "plainBody": "string",
  "htmlBody": "string",
  "replyToMessageId": "00000000-0000-0000-0000-000000000000"
} });

Example response · 201

{
  "id": "00000000-0000-0000-0000-000000000000",
  "inboxId": "00000000-0000-0000-0000-000000000000",
  "to": [
    "[email protected]"
  ],
  "cc": [
    "[email protected]"
  ],
  "bcc": [
    "[email protected]"
  ],
  "subject": "string",
  "plainBody": "string",
  "htmlBody": "string",
  "replyToMessageId": "00000000-0000-0000-0000-000000000000",
  "createdAt": "2026-05-01T08:11:44.754Z",
  "updatedAt": "2026-05-01T08:11:44.754Z"
}