List webhook endpoints | MVS Developer Docs

Lists all outbound webhook endpoints configured for the authenticated organization, ordered by most-recently created. The signing secret is never returned by this endpoint — it is only shown once, at creation.

Authentication

x-api-keystring

A scoped MvsPayApiKey, e.g. mvspay_live_…. Mint and scope keys from the dashboard (Settings → API Keys).

Response

The organization's webhook endpoints.

webhookslist of objects

totalinteger

Number of webhook endpoints returned.

Errors

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

1	{
2	"webhooks": [
3	{
4	"id": "whk_01HZX2sample",
5	"url": "https://example.com/webhooks/mvs-pay",
6	"events": [
7	"payment.succeeded",
8	"payment.failed"
9	],
10	"isActive": true,
11	"created_at": "2026-06-21T12:00:00.000Z",
12	"last_delivery_at": "2026-06-21T18:30:00.000Z",
13	"last_status": "DELIVERED",
14	"failure_count": 0,
15	"description": "Production billing listener"
16	}
17	],
18	"total": 1
19	}

$	curl https://pay.mvscloud.com/api/webhooks \
>	-H "x-api-key: <apiKey>"