---
title: "document:uploaded"
method: POST
path: "DocumentUploaded"
tags: ["Webhooks"]
---

# document:uploaded

`POST DocumentUploaded` (webhook)

A document was uploaded to an application.

## Headers

- `X-Akahu-Apply-Signature` string, required: Detached JWS over the request body, signed with `ES256`. The signing key is published at https://api.apply.akahu.nz/.well-known/jwks.json
- `X-Akahu-Apply-Request-Id` string, required: Unique per delivery attempt, including retries. Quote it when asking us about a delivery. Not an idempotency key - use the event `_id` for that.

## Payload

- DocumentUploadedWebhookEvent
  - `_id` string, required
  - `emitted_at` string, date-time, required
  - `payload` DocumentUploadedWebhookPayload, required
    - `type` 'document:uploaded', required
    - `_org` string, required
    - `_application` string, required
    - `_document` string, required

## Acknowledgement `200`

Event acknowledged.

---

[API](https://skmtc.dev/akahu/apis/akahu-apply-api.md) - [All operations](https://skmtc.dev/akahu/apis/akahu-apply-api/llms.txt) - [OpenAPI document](https://skmtc.dev/akahu/apis/akahu-apply-api/revisions/3f18eb1ead75?raw)
