Webhook Subscriptions API Reference

The Webhook Subscriptions API allows programmatic registration and management of webhook event notification URLs.

NOTE

For verifying incoming webhook payloads, see the Webhooks & Signature Verification Guide.

Methods

• client.Webhooks.List(ctx) -> ([]WebhookSubscription, error)
• client.Webhooks.Create(ctx, req) -> (*WebhookSubscription, error)
• client.Webhooks.Delete(ctx, id) -> error

---

1. Register a Webhook Subscription

sub, err := client.Webhooks.Create(ctx, &shopier.WebhookCreateRequest{
	Event: "order.created",
	URL:   "https://api.mybrand.com/webhooks/shopier",
})
if err != nil {
	log.Fatal(err)
}

fmt.Printf("Subscription Created! ID: %s\n", sub.ID)
// IMPORTANT: Save sub.Token securely. It is only returned upon initial creation.
fmt.Printf("Signing Secret Token: %s\n", sub.Token)

2. List Active Subscriptions

subs, err := client.Webhooks.List(ctx)
if err != nil {
	log.Fatal(err)
}

for _, s := range subs {
	fmt.Printf("[%s] Event: %s -> %s\n", s.ID, s.Event, s.URL)
}

3. Delete a Webhook Subscription

err := client.Webhooks.Delete(ctx, "wh_12345")
if err != nil {
	log.Fatal(err)
}