Contacts

Upload a new document for a contact (multipart)

POST
/api/contacts/{contactId}/documents/upload

Accepts a multipart/form-data upload (max 25 MB) and stores it in R2 under a deterministic per-contact key, then attaches the resulting document record to the contact. documentType must match an entry in the organization's configured documentTypes.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

contactId*string

Request Body

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/contacts/string/documents/upload" \  -F documentType="ID Proof" \  -F notes="Driver license front + back"
{  "success": true,  "document": {    "_id": "64f0a1b2c3d4e5f6a7b8ca40",    "storageKey": "org/64f0a1b2c3d4e5f6a7b8c9d3/contact/64f0a1b2c3d4e5f6a7b8c9d0/2026/id-proof.pdf",    "filename": "id-proof.pdf",    "contentType": "application/pdf",    "documentType": "ID Proof"  }}