Upload Invoice Document For Debt

{
  "error": false,
  "message": "Invoice document uploaded successfully",
  "data": {
    "id": "document_encrypted_id",
    "debt_id": "debt_encrypted_id",
    "internal_id": "DEBT-2026-001",
    "invoice_reference": "INV-2026-001",
    "original_filename": "invoice.pdf",
    "status": "active",
    "match_method": "manual",
    "created_at": "2026-07-04T10:30:00+00:00"
  }
}

Overview

Upload a PDF invoice document and attach it directly to a debt using the debt’s stable encrypted API ID. This endpoint is intended for the two-step flow: create or update the debt first, then upload the invoice PDF for that debt.

Authentication

Requires a valid OAuth 2.0 access token with the invoice_documents:write scope. The legacy debts:write scope is also accepted during the transition.

Example Request

curl

curl -X POST "/external-api/v1/debts/debt_encrypted_id/invoice-document" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "invoice=@./invoice.pdf;type=application/pdf"

Success Response

{
  "error": false,
  "message": "Invoice document uploaded successfully",
  "data": {
    "id": "document_encrypted_id",
    "debt_id": "debt_encrypted_id",
    "internal_id": "DEBT-2026-001",
    "invoice_reference": "INV-2026-001",
    "original_filename": "invoice.pdf",
    "status": "active",
    "match_method": "manual",
    "created_at": "2026-07-04T10:30:00+00:00"
  }
}

Errors

400 - Missing file, invalid upload, non-PDF file, or file too large
403 - Missing scope or invoice documents feature is not enabled
404 - Debt not found or not accessible
409 - The debt already has an invoice document and replace_manual was not set

Get started

Guides

SFTP integration

Company API

Creditors API

Debtors API

Debts API

Timelines API

Campaigns API

Settings API

Invoice documents API

Followups API

Todos API

Status API

Overview

Authentication

Example Request

Success Response

Errors

​Overview

​Authentication

​Example Request

​Success Response

​Errors

Overview

Authentication

Example Request

Success Response

Errors