Update Webhook

Update an existing webhook's configuration.

Endpoint

PATCH /v1/webhooks/{id}

Authentication

Requires an API key with the webhooks:write scope.

Parameters

Parameter	Type	Location	Description
id	integer	path	The webhook ID

Request Body

All fields are optional. Only provided fields will be updated.

Field	Type	Description
name	string	Webhook name (max 255 characters)
url	string	Endpoint URL
events	array	List of event types
is_active	boolean	Whether webhook is active

Example Request

curl -X PATCH "https://app.equipdash.com/api/v1/webhooks/3" \
  -H "Authorization: Bearer eqd_live_abc123xyz789..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Integration v2",
    "events": ["booking.created", "booking.cancelled", "booking.updated", "payment.received"],
    "is_active": true
  }'

Response

Success (200 OK)

Returns the updated webhook resource.

{
  "data": {
    "id": 3,
    "name": "My Integration v2",
    "url": "https://my-app.com/webhooks/equipdash",
    "events": ["booking.created", "booking.cancelled", "booking.updated", "payment.received"],
    "is_active": true,
    "failure_count": 0,
    "last_triggered_at": null,
    "created_at": "2026-01-15T12:00:00+00:00",
    "updated_at": "2026-01-15T12:30:00+00:00"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-01-15T12:30:00+00:00"
  }
}

Re-enabling Disabled Webhooks

If a webhook was auto-disabled due to delivery failures, you can re-enable it by setting is_active: true. The failure count will reset on the next successful delivery.

Errors

Status	Code	Description
401	authentication_required	No API key provided
401	invalid_api_key	Invalid API key
403	insufficient_scope	API key lacks webhooks:write scope
403	forbidden	Webhook belongs to different supplier
404	resource_not_found	Webhook does not exist
422	validation_error	Invalid request data