List webhooks
list_site_webhooks
Lists the webhook endpoints on a site and the events each one listens to.
Destination hosts are shown but full URLs are not, because a webhook URL is itself a credential. Each webhook comes back with its id, name, Host, payload type, events, whether it is on and its last delivery, and one call returns every webhook on the site.
Deliveries holds total, the deliveries sent, and failed, the ones that used up all their attempts, not counting tests. Disabled_Reason says why Modulify switched a webhook off on its own, after 20 deliveries in a row used up all their attempts. See Webhooks.
Request
Call it with a POST to https://api.modulify.ai/v1/list_site_webhooks, sending the inputs below as a JSON object. The token needs the config:read scope.
It only reads and changes nothing, so retrying it is safe.
curl -X POST https://api.modulify.ai/v1/list_site_webhooks \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"projectId":"PROJECT_ID"}'Over MCP, the same method is the list_site_webhooks tool.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
projectId |
string | Yes | The site id. |
Response
Every call answers with the JSON envelope of success, message, data, code and version. data holds the result described above, and on a method that returns a total, count carries it. The response headers carry the call's X-Request-Id and what is left of your per-minute budget in X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Errors explains every status code a call can answer with.