core.document.upload_completed - Chamelio Documentation

Event

core.document.upload_completed

This event fires when processing has finished successfully and the document is visible in Core. Its extracted fields can now be read with Get Contract Data.

Payload Example

{
  "event": "core.document.upload_completed",
  "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,
    "file_name": "vendor_agreement_q3.pdf",
    "document_type": "MSA",
    "document_title": "Master Services Agreement - Acme Corp",
    "source": "external_api",
    "actor": {
      "user_id": 1337,
      "email": "john.doe@example.com",
      "name": "John Doe"
    }
  }
}

Payload Fields

Envelope

Field	Type	Description
`event`	string	Always `core.document.upload_completed`
`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 Core document
`file_name`	string	Name of the uploaded file
`document_type`	string	Document type assigned during processing
`document_title`	string or null	Title extracted from the document
`source`	string	Where the document came from: `local`, `drive`, `sharepoint`, `email`, `workflow`, `integration`, `external_api`, `docusign`, `salesforce`, or `autosplit`
`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 is the event to act on when you want fully processed data. Call Get Contract Data with the document_id to read the extracted fields.