Webhooks as a service: send signed webhooks to your customers

// Error handling shortened; see the setup guide for the full program.
api, err := webhookrelay.New(os.Getenv("RELAY_KEY"), os.Getenv("RELAY_SECRET"))
if err != nil {
	log.Fatal(err)
}

// Once per customer: register the HTTPS endpoint they give you.
_, err = api.UpsertOutboundEventType(&webhookrelay.OutboundEventTypeOptions{
	Name:        "invoice.paid",
	Description: "An invoice was paid",
})
_, err = api.UpsertOutboundConsumer(&webhookrelay.OutboundConsumerOptions{ID: "customer_42", Name: "Acme"})
endpoint, err := api.CreateOutboundEndpoint(&webhookrelay.OutboundEndpointOptions{
	Consumer:    "customer_42",
	URL:         "https://acme.example/webhooks",
	EventTypes:  []string{"invoice.paid"},
	AutoDisable: true,
})
// endpoint.Secret is the signing secret your customer verifies deliveries with.

// Every time the event happens. Retrying with the same key never publishes twice.
message, err := api.PublishOutboundMessage(&webhookrelay.OutboundMessagePublishOptions{
	Consumer:       "customer_42",
	EventType:      "invoice.paid",
	Payload:        map[string]interface{}{"invoice_id": "inv_123", "amount": 4900},
	IdempotencyKey: "invoice-paid:inv_123",
})

# 1. Event type
curl --user "$RELAY_KEY:$RELAY_SECRET" -H 'Content-Type: application/json' \
  -X POST https://my.webhookrelay.com/v1/outbound/event-types \
  -d '{ "name": "invoice.paid", "description": "An invoice was paid" }'

# 2. Consumer (one of your customers, keyed by your own customer ID)
curl --user "$RELAY_KEY:$RELAY_SECRET" -H 'Content-Type: application/json' \
  -X PUT https://my.webhookrelay.com/v1/outbound/consumers/customer_42 \
  -d '{ "name": "Acme" }'

# 3. Endpoint (the response includes the whsec_ signing secret)
curl --user "$RELAY_KEY:$RELAY_SECRET" -H 'Content-Type: application/json' \
  -X POST https://my.webhookrelay.com/v1/outbound/consumers/customer_42/endpoints \
  -d '{ "url": "https://acme.example/webhooks", "event_types": ["invoice.paid"], "auto_disable": true }'

# 4. Publish (202 Accepted with a durable receipt)
curl --user "$RELAY_KEY:$RELAY_SECRET" -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: invoice-paid:inv_123' \
  -X POST https://my.webhookrelay.com/v1/outbound/messages \
  -d '{ "consumer": "customer_42", "event_type": "invoice.paid", "event_id": "evt_9001",
        "payload": { "invoice_id": "inv_123", "amount": 4900 } }'