POST Ping Subscription

Send a test delivery to your endpoint for a specific subscription. Useful for verifying connectivity and confirming your server handles payloads correctly.

Path parameters

No request body is required. WindBorne sends the signed ping immediately and returns 204 No Content when your endpoint accepts it. When the webhook or subscription is not active, the endpoint returns 422 Unprocessable Content. Calculated-product pings only inspect products calculated or published during the previous three days; when none matches the subscription's filters, the endpoint also returns 422 . A failed callback returns 502 Bad Gateway. The payload also includes webhook_note or subscription_note when those optional notes are configured.

When the subscription has response_options , the ping selects recent compatible forecast data and performs the real enrichment before delivery. This validates the same data.response shape and fetch behavior as an operational trigger.

Use the Calculation Times endpoint to inspect historical degree-day or tropical-cyclone availability beyond the ping window.

For tropical_cyclones.available and degree_days.available , the paired response option inherits the system event's model and initialization time; it does not accept a model.

A tropical_cyclones.available ping includes the base data.tropical_cyclone_ids array for the model run even when no response option is configured.

If enrichment fails, the ping fails without sending a partial payload.

Ping a subscription
Payload delivered to your endpoint
Content-Type: application/json
Trigger-Id: ping:10e4bc2b-7a66-4c75-91ae-a9d144dbc749
Webhook-Timestamp: 1786640400
Webhook-Signature: v1,<base64-hmac-sha256>
content-type: application/json