List webhook subscriptions

GET

/v1/webhooks

Paginated list of the org's webhook subscriptions — the same subscriptions managed on the dashboard's webhooks page. The signing secret is never returned; has_secret indicates whether one is set. Always paginated with the universal cursor envelope (default per_page 25, max 100); the cursor is opaque — clients MUST NOT parse it.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

Paginated webhook subscriptions

Bodyapplication/json

🟠400

🟠401

🟠403

🟠429

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.mailfloss.com/v1/webhooks?per_page=&cursor=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "data": [
        {
            "id": "aBcDeFgHiJkLmNoPq",
            "name": "CRM sync — undeliverables",
            "url": "https://example.com/mailfloss/webhook",
            "events": [
                "status-undeliverable",
                "job-finished"
            ],
            "data_source": "all",
            "active": true,
            "has_secret": true,
            "created_at": "2026-07-10T04:12:00.000Z",
            "updated_at": "2026-07-10T04:12:00.000Z"
        }
    ],
    "pagination": {
        "next_cursor": null,
        "has_more": false
    }
}

Modified at 2026-10-20 13:54:45

Get verification usage analytics

Create a webhook subscription