Sign in

v50

latestOpenAPI 3.0.0Proprietaryraw.githubusercontent.com2026-06-1841147599.2 KB
Webhooks

Update a webhook

Updates an existing webhook for the authenticated customer.

put/v3/webhooks/{id}

Path parameters

idstring uuid required

Headers

Idempotency-Keystring

Unique key to ensure idempotent request processing. Must be 1-255 alphanumeric characters, hyphens, or underscores. Responses are cached for 24 hours per key per customer.

x-profile-idstring uuid

Profile UUID to scope the request to a child profile. Only organization API keys can use this header. The profile must belong to the calling organization.

Request body

sandboxboolean

Sandbox flag - when true, the operation is simulated without side effects Useful for testing integrations without actual execution

display_namestring required
endpoint_urlstring
event_typesstring[]
event_filtersobject nullable
retry_countinteger
timeout_secondsinteger

Example request

{
  "display_name": "Updated Order Notifications",
  "endpoint_url": "https://example.com/webhooks/orders-v2",
  "event_types": [
    "message",
    "templates"
  ],
  "event_filters": {
    "message": [
      "delivered",
      "failed"
    ]
  },
  "retry_count": 5,
  "timeout_seconds": 60,
  "sandbox": false
}

Response

Webhook updated successfully

successboolean

Indicates whether the request was successful