Webhooks

Libro can notify your application when asynchronous events finish executing, such as massive document chunking.

Setting up Webhooks

1. Go to your Libro Dashboard -> Webhooks.
2. Add your endpoint (e.g. https://api.yourapp.com/webhooks/libro).
3. Select the events you want to subscribe to.

Webhook Payload

When a large ingestion finishes, you will receive a POST request:

{
  "event": "ingestion.complete",
  "data": {
    "userId": "user_999",
    "chunksProcessed": 450,
    "timeTakenMs": 1205
  }
}

Security Signature

Always verify the X-Libro-Signature header to ensure the webhook genuinely originated from our servers.