Get a webhook subscription

GET

/v1/webhooks/{id}

Returns one webhook subscription by id. The signing secret is never returned (has_secret indicates whether one is set). An id that does not exist or belongs to another org → 404 not_found. created_at/updated_at are null for subscriptions created in the dashboard before timestamps existed.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟢200

application/json

Webhook subscription

Bodyapplication/json

🟠401

🟠403

🟠404

🟠429

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Success

{
    "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"
}

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

Create a webhook subscription

Update a webhook subscription