Mail API reference

Mail API · Outbound-Webhooks

get/v1/workspaces/{workspace_id}/webhooks/attemptsAuth

Delivery attempts across all of this workspace's webhook endpoints, newest first, cursor-paginated, optionally for one event or one endpoint. Includes status code, latency, response body (truncated to 1KB), and error if any.

Path parameters

workspace_id*string · uuid

Id of the workspace.

Query parameters

limitinteger

Page size, 1–200 (default 50). Page further back with `cursor`.

cursorstring

Opaque cursor from the previous page's `pagination.next_cursor`. Omit for the first page.

event_idstring

Only the attempts for this event (`evt_<uuid>`).

endpoint_idstring · uuid

Only the attempts made to this endpoint.

Response · 200

data*array

Attempts, newest first.

pagination*object
next_cursor*string

Opaque cursor for the next page. `null` when no more pages are available.

Example: "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQwMDowMDowMFoifQ"

has_more*boolean

True iff another page exists; if true, pass `next_cursor` on the next request.

Example: false

Example

Request

GET https://api.mail.productcraft.co/v1/workspaces/{workspace_id}/webhooks/attempts
Authorization: Bearer YOUR_TOKEN

Response

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "event_id": "evt_3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f",
      "event_type": "email.bounced",
      "attempt_number": 0,
      "status_code": 0,
      "error_message": "string",
      "response_body_truncated": "string",
      "latency_ms": 0,
      "attempted_at": "2026-01-01T00:00:00.000Z",
      "url": "string",
      "domain_id": "00000000-0000-0000-0000-000000000000",
      "endpoint_id": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "pagination": {
    "next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQwMDowMDowMFoifQ",
    "has_more": false
  }
}