Webhook Events

Files picked

The user finished a hosted picker session (POST /v1/files/picker-sessions) and picked at least one file. The app can now open those files. Not sent on cancel.

postWebhookfile.picked

Payload

idstring required
testboolean

Always true when present: only a sample sent by POST /v1/webhooks/test with an event carries it. Real deliveries never do.

event'file.picked' required
timestampstring date-time required

Example payload

{
  "profiles": [
    {
      "externalId": "tenant_42"
    }
  ]
}

Response

Webhook received successfully

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.