Event Types

Tracore dispatches the following webhook events. Each event is delivered as a POST request to your webhook URL with a JSON payload.

document.received

Fired when a new document is uploaded to a schema.

{
  "event": "document.received",
  "timestamp": "2024-03-15T10:30:00Z",
  "data": {
    "documentId": "doc_abc123",
    "fileName": "invoice.pdf",
    "mimeType": "application/pdf",
    "pageCount": 3,
    "schemaKey": "invoice",
    "environmentSlug": "production",
    "workspaceSlug": "my-workspace"
  }
}

run.processing

Fired when an extraction run begins processing.

{
  "event": "run.processing",
  "timestamp": "2024-03-15T10:30:05Z",
  "data": {
    "runId": "run_xyz789",
    "documentId": "doc_abc123",
    "schemaKey": "invoice",
    "versionNumber": 1,
    "environmentSlug": "production",
    "workspaceSlug": "my-workspace"
  }
}

run.completed

Fired when an extraction run finishes successfully. The result field contains the extracted data.

{
  "event": "run.completed",
  "timestamp": "2024-03-15T10:30:12Z",
  "data": {
    "runId": "run_xyz789",
    "documentId": "doc_abc123",
    "schemaKey": "invoice",
    "versionNumber": 1,
    "environmentSlug": "production",
    "workspaceSlug": "my-workspace",
    "result": {
      "invoiceNumber": "INV-2024-001",
      "date": "2024-03-15",
      "totalAmount": 1250.00,
      "vendor": "Acme Corp"
    }
  }
}

run.failed

Fired when an extraction run fails or produces results that do not pass schema validation.

{
  "event": "run.failed",
  "timestamp": "2024-03-15T10:30:12Z",
  "data": {
    "runId": "run_xyz789",
    "documentId": "doc_abc123",
    "schemaKey": "invoice",
    "versionNumber": 1,
    "environmentSlug": "production",
    "workspaceSlug": "my-workspace",
    "error": "Document could not be parsed: unsupported format"
  }
}