Modulify

List webhooks

list_site_webhooks

Lists the webhook endpoints on a site and the events each one listens to.

POST /v1/list_site_webhooksScopeconfig:readRead only

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.