Webhooks API

Scope: webhooks.manage

Available today

List

GET /v1/webhooks

Secrets are never listed in plaintext after creation.

Get

GET /v1/webhooks/{id}

Create

POST /v1/webhooks
Idempotency-Key: ...

{
  "url": "https://example.com/hooks/ioneshop",
  "events": ["order.paid", "inventory.changed"],
  "description": "ERP"
}

Response includes secret once on create. Delivery verification: Webhooks.

Delete

DELETE /v1/webhooks/{id}

In development

These endpoints are documented for planning; they return errors until announced in the changelog:

PATCH /v1/webhooks/{id}
POST /v1/webhooks/{id}/rotate_secret
POST /v1/webhooks/{id}/test

Until rotate/test ship: delete + recreate the endpoint, or use Merchant BO tools when offered.