v1

latestOpenAPI 3.1.02026-07-2689175245.8 KB
Programmatic Webhooks

Update Webhook

Update a webhook subscriptions.

put/webhooks/{id}

Path parameters

idinteger required

The webhook's unique identifier.

Request body

topic'return' | 'label' | 'restock' | 'label.request' | 'giftcard' | 'happy.returns.shipment' required

The webhook's topic.

trigger'return.created' | 'return.updated' | 'return.closed' | 'label.created' | 'label.updated' | 'restock.requested' | 'label.request.issued' | 'label.request.cancelled' | 'giftcard.requested' | 'shipment.processed' required

The condition which triggers the webhook.

urlstring required

The webhook's URL.

status'active' | 'inactive' required

The webhook's status.

Example request

{
  "topic": "return",
  "trigger": "return.created",
  "url": "https://example.com/webhook"
}

Response

No Content