latestOpenAPI 3.0.12026-08-1781258463.9 KB

2ecf51b1543e

Neotimo/Webhooks

Creates a webhook subscription.

Returns the cleartext signing secret one time — store it. Later GETs expose only the 6-char prefix. The URL must be HTTPS on the default port 443; raw IP literals are refused and the resolved address is re-checked at connect time against the SSRF deny-list.

post/api/v1/neotimo/webhooks/subscriptions

Request body

namestring required

Caller-supplied label, surfaced in the partner dashboard.

urlstring required

HTTPS endpoint that receives the signed payload.

eventsstring required

Comma-separated list of event names (e.g. invoice.delivered,invoice.timeline.changed).

activeboolean

Whether the subscription is delivering events. Default true.

Response

Created