Mail API reference

Mail API · Outbound-Webhooks

get/v1/workspaces/{workspace_id}/webhooksAuth

List the workspace default + every per-domain override. Plaintext signing secrets are NOT returned — only the last-4-char hint. Mint or rotate via the secret endpoints to receive the plaintext (once). Deprecated: use `/webhooks/endpoints` instead. Responses carry `Deprecation: true` and `Sunset: Fri, 15 Jan 2027 00:00:00 GMT`; after 2027-01-15 this route returns 410. The slot is an ordinary endpoint (`legacy_slot` set) in `GET /webhooks/endpoints`.

Path parameters

workspace_id*string · uuid

Id of the workspace.

Response · 200

Array of object

id*string · uuid
workspace_id*string · uuid
domain_id*string · uuid

Null for the workspace-default config; set for a per-domain override.

url*string · uri
event_types*array
signing_secret_hint*string

Last 4 chars of the active signing secret.

prev_signing_secret_active*boolean

True while a previous signing secret is still being honoured (24h grace after rotation).

prev_signing_secret_expires_at*string · date-time
disabled_at*string · date-time

Set when auto-disabled after sustained failure.

disabled_reason*string
consecutive_failures*number
created_at*string · date-time
updated_at*string · date-time

Example

Request

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

Response

[
  {
    "id": "00000000-0000-0000-0000-000000000000",
    "workspace_id": "00000000-0000-0000-0000-000000000000",
    "domain_id": "00000000-0000-0000-0000-000000000000",
    "url": "string",
    "event_types": [
      "string"
    ],
    "signing_secret_hint": "string",
    "prev_signing_secret_active": false,
    "prev_signing_secret_expires_at": "2026-01-01T00:00:00.000Z",
    "disabled_at": "2026-01-01T00:00:00.000Z",
    "disabled_reason": "string",
    "consecutive_failures": 0,
    "created_at": "2026-01-01T00:00:00.000Z",
    "updated_at": "2026-01-01T00:00:00.000Z"
  }
]