Webhooks

List webhook subscriptions

Changed on

Returns a cursor-paginated list of webhook subscriptions configured for the team, ordered by created_at descending. The signing secret is never included. Pass cursor=<next_cursor> from the previous response to fetch the next page.

get/webhooks

Request

  • Base URL: https://app.sendmux.ai/api/v1
  • URL: https://app.sendmux.ai/api/v1/webhooks
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.sendmux.ai/oauth/authorize, token URL https://app.sendmux.ai/oauth/token, scopes: webhook.read)

Query parameters

cursorstring

Pagination cursor — the next_cursor from the previous response.

limitinteger

Maximum results (default 50, max 100)

Response

Subscription list

oktrue required

Example response

{
  "meta": {
    "request_id": "req_clxxxxxxxxxxxxxxxxxxxxxxxxx"
  },
  "data": [
    {
      "created_at": "2026-04-23T09:12:00Z",
      "enabled": true,
      "event_types": [
        "message.bounced",
        "message.received"
      ],
      "filters": {
        "mailbox_ids": [
          "mbx_clxxxxxxxxxxxxxxxxxxxxxxxxx"
        ]
      },
      "id": "whk_clxxxxxxxxxxxxxxxxxxxxxxxxx",
      "name": "Acme inbound forwarder",
      "updated_at": "2026-04-23T09:12:00Z",
      "url": "https://hooks.acme.com/sendmux"
    }
  ]
}

Changes