Webhooks: File Events

The File Event webhook fires when files are added to or removed from a folio. Use it to mirror client uploads into your own document store, kick off virus or quality scans, or update your CRM with new attachments.

Every payload is { event, client, folio, folio_section_file }.

file.added

When fired: When a file is uploaded to the folio. This includes uploads through the client portal, files received via email ingest, and files auto-imported from a connected storage provider (Google Drive, Dropbox, etc.).

{
  "event": "file.added",
  "client": {
    "id": 412,
    "guid": "f4a13d0c-2e5e-4a7d-9b1f-2e5a8f8d24c1",
    "user_guid": "1c3a9e8f-72b5-4d11-89aa-66ec0f3a4b22",
    "email": "client@example.com",
    "first_name": "Pat",
    "last_name": "Morgan",
    "phone": "+1-555-0142",
    "subscribed": "yes",
    "inserted_at": 1746825600,
    "updated_at": 1746825600
  },
  "folio": {
    "guid": "8b9d7c12-aa7e-4a2c-b91d-3ad7c2f81f54",
    "client_guid": "f4a13d0c-2e5e-4a7d-9b1f-2e5a8f8d24c1",
    "type": "inbound",
    "name": "Onboarding",
    "status": "open",
    "template_guid": "a72b1c4a-19fc-4d68-8ac6-b6ccf1f3e000",
    "folio_sections": [],
    "inserted_at": 1746825000,
    "updated_at": 1746829800
  },
  "folio_section_file": {
    "id": 8821,
    "guid": "5dca7f10-21bd-4e7b-91c6-7ce1aa19c7d2",
    "section_guid": "c0a13a2e-9e91-4c1a-a8c7-78f3f9e2e21d",
    "status": "uploaded",
    "filename": "passport.pdf",
    "content_type": "application/pdf",
    "content_size": 384122,
    "field_guid": "1f3e7a90-44c2-4d9b-9b8e-ac21d5e5d710",
    "storage_service": "folio",
    "storage_uid": "objects/8821/passport.pdf",
    "storage_location": "us-east-1",
    "inserted_at": 1746829800,
    "updated_at": 1746829800
  }
}

file.removed

When fired: When you delete a file from a folio.

{
  "event": "file.removed",
  "client": { "...": "see file.added above" },
  "folio": { "...": "see file.added above" },
  "folio_section_file": {
    "id": 8821,
    "guid": "5dca7f10-21bd-4e7b-91c6-7ce1aa19c7d2",
    "section_guid": "c0a13a2e-9e91-4c1a-a8c7-78f3f9e2e21d",
    "status": "removed",
    "filename": "passport.pdf",
    "content_type": "application/pdf",
    "content_size": 384122,
    "field_guid": "1f3e7a90-44c2-4d9b-9b8e-ac21d5e5d710",
    "storage_service": "folio",
    "storage_uid": "objects/8821/passport.pdf",
    "storage_location": "us-east-1",
    "inserted_at": 1746829800,
    "updated_at": 1746830400
  }
}

More information

For headers, signing, retries, and the delivery log, see the Webhooks overview.