core.document.uploaded - Chamelio Documentation

Event

core.document.uploaded

This event fires once a document has been accepted and a Core document record exists. Extraction has not finished yet - wait for core.document.upload_completed before reading extracted fields.

Payload Example

{
  "event": "core.document.uploaded",
  "event_id": "3f7c1a8e-5b2d-4e9a-9c31-8a6f0d4b7e12",
  "organization_id": 42,
  "user_id": 1337,
  "payload_version": 1,
  "timestamp": "2026-09-02T14:32:00Z",
  "data": {
    "document_id": 88213,
    "document_processing_id": 4471,
    "file_name": "vendor_agreement_q3.pdf",
    "document_category": "contract",
    "source": "external_api",
    "external_identifier": "crm-8842",
    "actor": {
      "user_id": 1337,
      "email": "john.doe@example.com",
      "name": "John Doe"
    }
  }
}

Payload Fields

Envelope

Field	Type	Description
`event`	string	Always `core.document.uploaded`
`event_id`	string	UUID for this delivery. Use it to deduplicate retries
`organization_id`	integer	ID of the organization the event occurred in
`user_id`	integer or null	ID of the user who triggered the event
`payload_version`	integer	Envelope schema version. Currently `1`
`timestamp`	string	ISO 8601 UTC timestamp of when the event was generated
`data`	object	Event-specific payload (see below)

Data Object

Field	Type	Description
`document_id`	integer	ID of the created Core document
`document_processing_id`	integer	ID of the processing job handling this upload
`file_name`	string	Name of the uploaded file
`document_category`	string	Category of the document: `contract`, `policy`, `template`, or `archive`
`source`	string	Where the document came from: `local`, `drive`, `sharepoint`, `email`, `workflow`, `integration`, `external_api`, `docusign`, `salesforce`, or `autosplit`
`external_identifier`	string or null	Identifier you supplied on upload, if any
`actor`	object	The user who uploaded the document (see below)

Actor Object

Chamelio resolves the acting user at send time. user_id is present whenever a user triggered the event; email and name are filled in only if that user could still be resolved in the organization.

Field	Type	Description
`user_id`	integer or null	ID of the user who triggered the event
`email`	string or null	Email of that user
`name`	string or null	Full name of that user

This event means the upload was accepted, not that the document is ready. Extracted fields are not available until core.document.upload_completed arrives.