PATCH
/webhooks/:idUpdate Webhook
Update an existing webhook endpoint's URL, events, or status
Scope: WEBHOOKS_WRITE
Overview
Updates an existing webhook endpoint. All fields are optional — only the provided fields are changed. Use isActive to enable or disable an endpoint without deleting it.
Request
PATCH
/webhooks/:idPath Parameters
Headers
| Header | Value |
|---|---|
Authorization | Bearer fxk_live_<your-api-key> |
Content-Type | application/json |
Request Body
Example Request
curl -X PATCH "https://api.formfex.com/api/v1/public/webhooks/WEBHOOK_ID" \
-H "Authorization: Bearer $FORMFEX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"events": ["FORM_RESPONSE_CREATED"],
"isActive": true
}'Response
Response Fields
| Field | Type | Description |
|---|---|---|
data.id | string | Unique webhook endpoint identifier (UUID) |
data.url | string | HTTPS URL that receives webhook events |
data.events | string[] | Array of subscribed event types |
data.secretLast4 | string | Last 4 characters of the signing secret |
data.isActive | boolean | Whether the endpoint is currently active |
data.description | string | null | Optional description |
data.createdAt | string | ISO 8601 creation timestamp |
data.updatedAt | string | ISO 8601 last update timestamp |
Error Cases
| Status | Cause |
|---|---|
404 | Webhook endpoint not found or not owned by this account |
409 | Another webhook endpoint with the new URL already exists |
Notes
Re-enabling disabled endpoints
If an endpoint was automatically disabled after 5 consecutive delivery failures, set isActive to true to re-enable it. Make sure the underlying issue is resolved first.