Verify a builder webhook destination
Changed onActivates a pending webhook destination. Two conditions must both hold: the one-time verification token matches and has not expired, AND the destination answers 2xx to a signed challenge this operation POSTs to the endpoint's stored url. The challenge body is {"type":"webhook.verification","token":"<verification_token>","webhook_id":<id>}. It carries x-0xinsider-event-type: webhook.verification plus the same x-0xinsider-timestamp and x-0xinsider-signature headers a delivery carries, signed with that endpoint's signing_secret, so verify it exactly as you verify a delivery. Answer any 2xx within 10 seconds; the challenge response body is never read, and the challenge follows no redirects. A status outside 2xx, no answer within 10 seconds, or a url that does not resolve to a publicly routable address leaves status at pending_verification and returns 422. The token alone never activates an endpoint.
Request
- Base URLhttps://api.0xinsider.com
- Auth
- HTTP bearer
- or OAuth 2Authorization codehttps://0xinsider.com/oauth/authorizeToken URLhttps://api.0xinsider.com/oauth/tokenScopeswebhooks
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
Webhook endpoint id owned by the authenticated API key user.
Headers
Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs, including when its percent escape is incomplete.
Request body
Response
Webhook destination
Changes
- warning
added the new
large_trade_inserted_v2enum value to the//response property for the response status - info
added the required property
/to the response with the status
- warning
- warning
added the new
sharp_money_flow_detectedenum value to the//response property for the response status
- warning