Skip to main content
POST
/
api
/
v1
/
webhooks
/
{id}
/
verify
cURL
curl -sS \
  -X POST \
  -H 'Authorization: Bearer $OXI_SK' \
  -H 'Content-Type: application/json' \
  -d '{"verification_token":"whv_example"}' \
  'https://api.0xinsider.com/api/v1/webhooks/{id}/verify'
{
  "object": "<string>",
  "data": {
    "id": 123,
    "object": "<string>",
    "name": "<string>",
    "url": "<string>",
    "event_types": [],
    "verification_token_expires_at": "2023-11-07T05:31:56Z",
    "failure_count": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "retry_policy": {
      "max_attempts": 123,
      "terminal_status": "<string>"
    },
    "verified_at": "2023-11-07T05:31:56Z",
    "signing_secret": "<string>",
    "verification": {
      "token": "<string>",
      "expires_at": "2023-11-07T05:31:56Z"
    }
  },
  "meta": {
    "request_id": "<string>",
    "cached": true,
    "cache_age_s": 123
  }
}
Activate a webhook by returning the verification_token you received when you created it. A new endpoint stays in pending_verification and receives no deliveries until it is verified. The token expires 24 hours after create. 
curl -X POST \
  -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"verification_token": "whv_3c2e...redacted"}' \
  "https://api.0xinsider.com/api/v1/webhooks/42/verify"
On success the endpoint flips to active and deliveries begin. This call does not send a test delivery; it activates the endpoint by matching the token. The webhook id is the integer returned at create. For the signature scheme and copy-pasteable verification code, see the Webhooks guide.

Authorizations

​
Authorization
string
header
required

API key: Authorization: Bearer oxi_sk_live_... for live data (requires an active Insider subscription), or oxi_sk_test_... for sandbox/test mode (free account, deterministic fixture data, no live rows). Both key classes use the same paths; the prefix selects live vs sandbox.

Path Parameters

​
id
integer<int64>
required

Webhook endpoint id owned by the authenticated API key user.

Body

application/json
​
verification_token
string
required

Response

Webhook destination

​
object
string
required
Allowed value: "webhook"
​
data
object
required
​
meta
object
required