PUT /v1/webhooks/{id} — update a webhook

The Update Webhook endpoint lets you modify a webhook subscription without deleting and recreating it. This preserves the HMAC signing secret, so receivers don’t need to update their verification logic. Only fields included in the request body are updated. Omitted fields remain unchanged.

Endpoint

PUT https://0k90mc4jjj.execute-api.us-east-2.amazonaws.com/v1/webhooks/{id}

Authentication

string

required

Bearer token using your API key. Format: Bearer cs_live_your_key

Path parameters

string

required

The webhook ID to update.

Request body

string

New HTTPS URL for webhook delivery. HTTP is allowed in development environments only.

string[]

Updated list of event types to subscribe to. Replaces the existing list entirely.Supported events: donation.created, donation.updated, subscription.created, subscription.updated, subscription.cancelled, contact.created, contact.updated, form.created, form.updated

string

Set to ACTIVE to resume delivery or DISABLED to pause without deleting. This is useful for temporarily muting a webhook during maintenance.

string

Updated description for the webhook.

Response

string

required

Confirmation message.

object

required

The updated webhook object. Does not include the signing secret.

Example

cURL

curl -X PUT https://0k90mc4jjj.execute-api.us-east-2.amazonaws.com/v1/webhooks/wh_abc123 \
  -H "Authorization: Bearer cs_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhooks/v2",
    "events": ["donation.created", "donation.updated", "subscription.created"]
  }'

200 response

{
  "message": "Webhook updated successfully",
  "webhook": {
    "webhookId": "wh_abc123",
    "url": "https://example.com/webhooks/v2",
    "events": ["donation.created", "donation.updated", "subscription.created"],
    "status": "ACTIVE",
    "description": "Production webhook",
    "createdAt": 1714300000,
    "lastDeliveryAt": 1714350000,
    "successCount": 42,
    "failureCount": 0
  }
}

Status codes

Code	Description
200	Webhook updated successfully
400	Invalid request (bad URL, unsupported events, no valid fields)
401	Missing or invalid API key
403	Webhook belongs to a different merchant
404	Webhook not found

Organization

Payments

Subscriptions

Contacts

Forms

Prefilled-Checkout Links

Webhooks

Analytics

PUT /v1/webhooks/{id} — update a webhook

Endpoint

Authentication

Path parameters

Request body

Response

Example

Status codes

​Endpoint

​Authentication

​Path parameters

​Request body

​Response

​Example

​Status codes

Endpoint

Authentication

Path parameters

Request body

Response

Example

Status codes