Dropship Webhooks
List Dropship Webhooks
List the account's dropship webhook endpoints. Requires the `portal.manage` permission.
Create Dropship Webhook
Register a webhook endpoint for the account. Requires the `portal.manage` permission. Returns 201 with the subscription plus its signing `secret` — **the only time the secret is returned**; store it now (use Rotate Dropship Webhook Secret if it is lost).
Update Dropship Webhook
Change an endpoint's URL, events or on/off switch. Omitted fields stay as they are. Setting `active` to true on a switched-off endpoint clears its failure count and `disabled_at`. Requires the `portal.manage` permission.
Delete Dropship Webhook
Delete an endpoint. No further events are sent to it. Requires the `portal.manage` permission.
Send Test Dropship Webhook
Send a signed `test` event to the endpoint right now and return the logged delivery. Test events are sent once (never retried) and never count toward the auto-disable threshold, and they are sent even when the endpoint is switched off. Requires the `portal.manage` permission; limited to 20 requests per minute. No request body.
Rotate Dropship Webhook Secret
Issue a new signing secret for the endpoint. The old secret stops working immediately — every delivery from now on, including retries of earlier events, is signed with the new one. The new secret is returned once and never again. Requires the `portal.manage` permission. No request body.
List Dropship Webhook Deliveries
The endpoint's delivery log, newest first, paginated. One row per event (retries update the same row, so `attempt` is the number of attempts made). Requires the `portal.manage` permission.