MailerGetWebhookEvents

GET mailer/webhookEvents/list

Returns the raw provider events the module received, with the payload and what the module did with each one.

Every event is stored, including ignored and unverified ones. Without that record a signature mismatch or a duplicate would be invisible, and a dispute with the provider about a complaint would come down to guesses.

Access Control

Allowed role: admin.

Request

RESTTCPSDK

GET request

GET https://{broker_domain}/mailer/webhookEvents/list?limit=50&orderBy=%5B%22id%22%2C%22DESC%22%5D&where=%7B%22result%22%3A%22UNVERIFIED%22%7D
Authorization: <JWT_TOKEN>

{
  "command": "MailerGetWebhookEvents",
  "extID": "1",
  "data": {
    "limit": 50,
    "orderBy": [
      "id",
      "DESC"
    ],
    "where": {
      "result": "UNVERIFIED"
    }
  }
}

const res = await platform.MailerGetWebhookEvents({
  limit: 50,
  orderBy: [
    "id",
    "DESC"
  ],
  where: {
    result: "UNVERIFIED"
  }
});

Request Data

Field	Type	Required	Description
limit	int	No	Page size, 1..1000, default 100
offset	int	No	Rows to skip
orderBy	array	No	Sorting, for example ["id", "DESC"]
count	array	No	Row count aggregate, ["id"]
where	object	No	Filters, see Table filter syntax

Behavior

• Events are deduplicated by the provider event id: a repeated delivery is stored once with result: "DUPLICATE" and does not change the email again.
• Old events are purged by a cron according to the retention setting, so the table cannot grow without bound.

Response Data

Results: PROCESSED, DUPLICATE, IGNORED, UNVERIFIED, NO_EMAIL, ERROR. NO_EMAIL means the event referenced a message this brand does not have.

{
  "rows": [
    {
      "id": 5121,
      "webhookId": 2,
      "webhookUuid": "9f2a1c7d4b6e",
      "providerEventId": "EV-99213-1",
      "result": "PROCESSED",
      "emailId": 812,
      "error": null,
      "payload": { "RecordType": "Bounce", "Type": "HardBounce" },
      "createdAt": "2026-08-24 13:32:49"
    }
  ]
}

Errors

Code	Error	Description
401	PERMISSION_DENIED	Not an admin session