API referenceWebhooks
Retrieve a webhook
Scope webhooks:read.
apiKeyheader
AuthorizationBearer <fv_live_… or fv_test_…>id*stringFormat
uuidThe webhook
application/json- response
success*booleanrequest_id*stringFormat
uuiddata?curl -X GET 'https://api.flowverify.co/v1/webhooks/497f6eca-6276-4993-bfeb-53cbbbba6f08'Example Response
{ "success": true, "request_id": "266ea41d-adf5-480b-af50-15b940c2b846", "data": { "object": "webhook", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "url": "string", "events": [ "string" ], "description": "string", "is_active": true, "api_version": "string", "last_delivery_at": "2019-08-24T14:15:22Z", "last_status": "string", "consecutive_failures": 0, "disabled_at": "2019-08-24T14:15:22Z", "disabled_reason": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" }}Create a webhook subscription POST
Scope `webhooks:manage`. The endpoint must be a public http(s) URL (HTTPS in production; private, loopback and cloud-metadata addresses are refused). The signing `secret` is returned **once** in this response. At most 20 webhooks per organization.
Update a webhook PATCH
Scope `webhooks:manage`. Setting `is_active` to true re-enables an auto-disabled webhook and resets its failure counter.