/v1 endpoints and help with validation and webhook parsing. Authentication is always your ps_ API key.
Node.js / TypeScript
Package:@pilot-status/sdk
Webhook events the SDK does not know
The platform adds events, and a webhook subscribed to"*" receives a new one the day it ships — before you upgrade. Starting with 0.12.0, parseCustomerWebhook does not throw on an event name it does not know: it returns { type: "unknown", event, data, raw } (UnknownCustomerWebhookEvent) — event and data as received, raw the whole body, nothing validated. Acknowledge it with a 2xx and ignore it.
event, and on a known event whose fields break its contract. isCustomerWebhookEvent stays strict: false for an unknown event name.
Python
Package:pilot-status
{"type": "unknown", "event", "data", "raw"} instead of raising; tell it apart with is_unknown_customer_webhook_event and answer it with a 2xx:
WebhookParseError is still raised for a body that is not an object with a string event and for a known event with invalid fields. Pass unknown_events="raise" to keep the old behaviour; is_customer_webhook_event stays strict. flow.response_received, which the Python parser does not model, now comes back as unknown instead of raising.
n8n (native integration)
Official community node:n8n-nodes-pilot-status.
Install from the n8n UI: Settings → Community Nodes → Install → n8n-nodes-pilot-status. Authentication uses a Pilot Status API key.
For inbound events, add the Pilot Status Trigger node to your workflow, copy its webhook URL, and paste it as a new webhook on the Webhooks page in the Pilot Status dashboard. Every subscribed event then starts your workflow. With All Events selected, the Trigger passes any event through with the body untouched — including events newer than your node version; with a specific event selected, anything else is answered
200 Ignored event.Best practices
- Keep the API key on the backend only — never in browser code.
- For
429/5xxresponses, retry with exponential backoff (the SDKs help, but the retry policy is up to your system).