List webhook endpoints
Returns webhook endpoints owned by the caller scope. Merchant callers see only their own endpoints; tenant/platform callers see endpoints at their owner level. Signing secrets are never included in list responses.
curl -X GET "https://api.miracle.com/v1/webhooks/endpoints"{
"data": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"ownerType": "merchant",
"ownerId": "string",
"tenantId": "f97df110-f4de-492e-8849-4a6af68026b0",
"url": "http://example.com",
"description": "string",
"events": [
"string"
],
"status": "active",
"createdAt": "string",
"updatedAt": "string",
"deletedAt": null
}
]
}Get webhook endpoint
Returns a single webhook endpoint by ID. Ownership is verified against the caller scope. The signing secret is never returned on read — use POST .../rotate-secret to generate a new one.
List available webhook event types
Returns the catalog of event types the caller may subscribe to. Results are filtered by the caller owner level (merchant, tenant, or platform) — lower-privilege callers see a narrower catalog. Use this list to discover valid values for the `events` field when creating or updating a webhook endpoint.