Create a webhook

POSThttps://myagentmail.com/v1/webhooks

Request body

Content-Type: application/json

`url` required string	format: uri
`events` required "message.received" \| "message.sent" \| "message.bounced"[]

Responses

201application/jsonCreated

`id` string	format: uuid
`url` string	format: uri
`events` "message.received" \| "message.sent" \| "message.bounced"[]
`secret` string	HMAC-SHA256 secret. Only returned on creation.
`isActive` boolean
`createdAt` 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/webhooks
const result = await client.request("post", "/v1/webhooks", { body: {
  "url": "https://example.com",
  "events": [
    "message.received"
  ]
} });

Example response · 201

{
  "id": "00000000-0000-0000-0000-000000000000",
  "url": "https://example.com",
  "events": [
    "message.received"
  ],
  "secret": "string",
  "isActive": false,
  "createdAt": "2026-05-01T08:11:44.872Z"
}