Webhooks

Webhooks allow your system to receive real-time notifications when important events occur in your VKRA account, such as clicks or conversions.

Configurable Events

You can subscribe to the following events:

Webhook Configuration

Endpoint

POST /webhooks

Request Body

{
  "url": "https://your-app.com/webhooks/adtokens",
  "events": ["click", "conversion"]
}

Receiving a Webhook

VKRA sends webhooks as POST requests with a JSON payload.

Example Payload (click event)

{
  "id": "evt_123",
  "type": "click",
  "created_at": "2024-01-15T10:30:00Z",
  "data": {
    "impression_id": "imp_abc456",
    "product_id": "product_789",
    "request_id": "req_550e..."
  }
}

Security & Verification

We recommend verifying the webhook signature to ensure that the request originated from VKRA.

(Note: Signature verification details will be provided as we roll out the enterprise webhook suite in Q1 2026.)

Best Practices

• Return a 2xx Promptly: Your webhook handler should acknowledge receipt immediately. Perform long-running processing in a background task.
• Idempotency: Ensure your webhook handler is idempotent, as VKRA may occasionally send the same event more than once.
• Secure Endpoints: Use HTTPS for your webhook destination URLs.