List webhooks

Retrieve a paginated list of webhooks belonging to the given mail order.

List webhooks

get

Retrieve a paginated list of webhooks belonging to the given mail order. Supports filtering by mailbox and status. The webhook secret is never included; it is returned only when a webhook is created or its secret is regenerated.

Authorizations

AuthorizationstringRequired

API Token authentication

Path parameters

orderIdstringRequired

Order resource ID

Example: OR1a2b3c4d5e6f7g

Query parameters

mailbox_idstring · nullableOptional

Filter by the mailbox resource ID the webhooks are attached to

Example: AC1a2b3c4d5e6f7g

statusstring · enum · nullableOptional

Filter webhooks by status

Example: activePossible values:

pageintegerOptional

Page number

Example: 1

per_pageinteger · max: 100Optional

Number of items per page

Default: 25Example: 25

Responses

200

Success response

application/json

401

Unauthenticated response

application/json

404

Error response

application/json

422

Error response

application/json

500

Error response

application/json

get/api/mail/v1/orders/{orderId}/webhooks

GET /api/mail/v1/orders/{orderId}/webhooks HTTP/1.1
Host: developers.hostinger.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "id": "019683f8-1234-7abc-8def-0123456789ab",
      "mailbox": {
        "id": "AC1a2b3c4d5e6f7g",
        "address": "[e-mail]"
      },
      "name": "New message notifier",
      "description": "Notifies our CRM when a new email arrives",
      "events": [
        "message.received"
      ],
      "status": "active",
      "url": "https://example.com/webhooks/incoming",
      "created_at": "2026-07-23T12:00:00Z",
      "updated_at": "2026-07-23T12:00:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 15,
    "total": 100
  }
}