Create a webhook endpoint

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

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

Scope webhooks:manage

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

Language

Credentials

Bearer

URL

https://api.sandbox.stridehq.ai/v1

Request

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"
  ]
}'

Response

{
  "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"
}

Example response. Try it opens with the sandbox.