Update Webhook

Update an existing webhook’s configuration.

PUT /api/v2/public/webhook/:id

cURL

curl -X PUT "https://app.refold.ai/api/v2/public/webhook/{id}" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "is_enabled": false, "webhook_events": ["Workflow Completed"] }'

200

{
  "_id": "6a313eda6d5528bdcf71ebac",
  "org_id": "6500a1b2c3d4e5f6a7b8c9d0",
  "environment": "test",
  "is_enabled": false,
  "webhook_events": ["Workflow Completed"],
  "workflow_ids": [],
  "webhook_url": "https://your-app.com/webhooks",
  "webhook_body": "{{event}}",
  "method": "POST",
  "webhook_type": "default",
  "updatedAt": "2026-06-16T12:17:46.860Z"
}

Update a webhook’s events, URL, enabled state, or delivery settings. Only the fields you send are changed.

Authentication

Webhooks are an org-level resource, so this endpoint uses API-key auth.

x-api-key · string · required

Your Refold API key. Find it in Settings → Credentials.

Path Parameters

id · string · required

The webhook ID to update.

Body Parameters

webhook_events · array

Replacement list of subscribed events.

webhook_url · string

New delivery URL (^https?://).

is_enabled · boolean

Enable or disable the webhook.

webhook_type · string

Payload format: default, slack, or custom.

method · string

Delivery method: POST, PUT, or PATCH.

webhook_headers · object

Custom delivery headers.

webhook_body · any

Custom payload template.

workflow_ids · array

Restricted workflow IDs.

Response

200 OK

Returns the updated webhook object.

400 Not Found

status_code · integer

HTTP status code.

http_error_type · string

Error category.

error · string

Internal error code, e.g. RESOURCE_NOT_FOUND.

message · string

Human-readable error description.

200

{
  "_id": "6a313eda6d5528bdcf71ebac",
  "org_id": "6500a1b2c3d4e5f6a7b8c9d0",
  "environment": "test",
  "is_enabled": false,
  "webhook_events": ["Workflow Completed"],
  "workflow_ids": [],
  "webhook_url": "https://your-app.com/webhooks",
  "webhook_body": "{{event}}",
  "method": "POST",
  "webhook_type": "default",
  "updatedAt": "2026-06-16T12:17:46.860Z"
}

cURL

curl -X PUT "https://app.refold.ai/api/v2/public/webhook/{id}" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "is_enabled": false, "webhook_events": ["Workflow Completed"] }'