Skip to main content
PUT
/
api
/
v2
/
public
/
webhooks
/
group
/
edit
curl -X PUT "https://app.refold.ai/api/v2/public/webhooks/group/edit" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "webhookIds": ["6a313eda6d5528bdcf71ebac"],
    "group": "billing-webhooks"
  }'
[
  {
    "_id": "6a313eda6d5528bdcf71ebac",
    "org_id": "6500a1b2c3d4e5f6a7b8c9d0",
    "environment": "test",
    "is_enabled": false,
    "webhook_events": ["Workflow Completed"],
    "webhook_url": "https://your-app.com/webhooks",
    "group": "billing-webhooks",
    "webhook_type": "default",
    "method": "POST"
  }
]
Assign (or clear) a group label on multiple webhooks in one call. Groups let you organize webhooks; passing an empty/falsy group unsets it. The response is the updated list of the affected webhooks.

Authentication

x-api-key
string
required
Your Refold API key. Find it in Settings → Credentials.

Body Parameters

webhookIds
array
required
IDs of the webhooks to update (at least one).
group
string
Group label to set. An empty string unsets the group.

Response

Returns the array of updated webhooks.
[
  {
    "_id": "6a313eda6d5528bdcf71ebac",
    "org_id": "6500a1b2c3d4e5f6a7b8c9d0",
    "environment": "test",
    "is_enabled": false,
    "webhook_events": ["Workflow Completed"],
    "webhook_url": "https://your-app.com/webhooks",
    "group": "billing-webhooks",
    "webhook_type": "default",
    "method": "POST"
  }
]
curl -X PUT "https://app.refold.ai/api/v2/public/webhooks/group/edit" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "webhookIds": ["6a313eda6d5528bdcf71ebac"],
    "group": "billing-webhooks"
  }'