Create a webhook endpoint

POSThttps://api.sandbox.stridehq.ai/v1/webhook_endpoints

Not available yet. This endpoint is planned and may change before it’s released.

Adds an endpoint. The signing secret is only returned here, once.

Scope webhooks:manage

View as Markdown

Headers

Idempotency-Key string

A unique value, such as a UUID. The same key and body within 24 hours returns the original response.

Body parameters

url stringrequired

An HTTPS address.

events array of stringrequired

The event types to send.

Responses

curl -X POST "https://api.sandbox.stridehq.ai/v1/webhook_endpoints" \ -H "Authorization: Bearer $STRIDEHQ_API_KEY" \ -H "Idempotency-Key: 5f2b9c1e-3a7d-4e8f-9b0c-1d2e3f4a5b6c" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com/webhooks/stridehq", "events": [ "payment_run.funded", "payment_run.completed", "payment.failed" ] }'

{ "id": "we_5e7a9c1b3d5f4a6c8e0a2b4c6d8e0f1a", "object": "webhook_endpoint", "url": "https://example.com/webhooks/stridehq", "events": [ "payment_run.funded", "payment_run.completed", "payment.failed" ], "enabled": true, "created_at": "2026-10-29T09:00:00Z", "secret": "whsec_demo_9f8e7d6c5b4a" }