> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chamelio.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# core.document.uploaded

> Fired as soon as a new document is uploaded to Chamelio Knowledge Center, before asynchronous processing begins, so integrations react to raw uploads.

## Event

```
core.document.uploaded
```

This event fires once a document has been accepted and a Knowledge Center document record exists. Extraction has not finished yet - wait for [`core.document.upload_completed`](https://docs.chamelio.ai/api-reference/webhooks/core/document-upload-completed) before reading extracted fields.

## Payload Example

```json theme={null}
{
  "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 Knowledge Center 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 |

> [!WARNING]
>
> This event means the upload was accepted, not that the document is ready. Extracted fields are not
> available until `core.document.upload_completed` arrives.
