Create Invoice | Papertracc Docs

curl -X POST https://api.papertracc.com/v1/invoices \
     -H "Authorization: Bearer <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "customer_id": "7d2c9c72-392c-4f8d-b3f1-c1fef2c2d501",
  "invoice_date": "2026-06-18T10:00:00.000Z",
  "items": [
    {
      "detail": "Implementation consulting services",
      "currency_code": "NGN",
      "quantity": 10,
      "rate": 50000,
      "sku": "SKU-1001",
      "account_id": "d037d299-3029-4dc7-8e72-172f80f23c4f",
      "amount": 500000,
      "tax_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1"
    }
  ],
  "debit_account_id": "d037d299-3029-4dc7-8e72-172f80f23c4f",
  "sales_personnel_id": "7d2c9c72-392c-4f8d-b3f1-c1fef2c2d501",
  "order_id": "ORD-1001",
  "subject": "Implementation consulting services",
  "due_date": "2026-07-18T10:00:00.000Z",
  "reverse_charge": false,
  "adjustments": [
    {
      "name": "VAT",
      "account_id": "2b0d1461-e52e-4a1a-a69c-11801431c2c9",
      "value": 7.5,
      "type": "PERCENTAGE_RATE",
      "operation": "ADDITION",
      "amount": 37500
    }
  ],
  "allow_post": false
}'

{
  "data": {
    "id": "1243891e-40a8-4a88-8e1f-0397adcbf85e",
    "invoice_reference": "INV-0001",
    "project_id": "spruce-demo",
    "prepared_by": "user-token-hash",
    "amount": "537500.00",
    "total_paid": "0.00",
    "payment_status": "UNPAID",
    "status": "DRAFT",
    "journal_status": "UNPOSTED",
    "currency_code": "NGN",
    "exchange_rate": "1.00",
    "order_id": "ORD-1001",
    "reverse_charge": false,
    "is_overdue": false,
    "approval": 0,
    "content": {},
    "items": [
      {
        "detail": "Consulting hours",
        "tax_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1",
        "quantity": 10,
        "rate": "50000.00",
        "amount": "500000.00",
        "inventory_id": "55a40b4d-a23a-49aa-a417-828913e9a5c8",
        "currency_code": "NGN",
        "account_id": "d037d299-3029-4dc7-8e72-172f80f23c4f"
      }
    ],
    "adjustments": [
      {
        "name": "VAT",
        "account_id": "2b0d1461-e52e-4a1a-a69c-11801431c2c9",
        "value": "7.50",
        "type": "PERCENTAGE_RATE",
        "operation": "ADDITION",
        "amount": "37500.00"
      }
    ],
    "customer": {
      "id": "7d2c9c72-392c-4f8d-b3f1-c1fef2c2d501",
      "type": "INDIVIDUAL",
      "email": "john@example.com",
      "phone": "+2348012345678",
      "accounts": [
        {
          "bank": "Spruce Bank",
          "code": "044",
          "vat_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1",
          "is_default": true,
          "account_name": "John Doe",
          "currency_code": "NGN",
          "account_number": "1234567890"
        }
      ],
      "last_name": "Doe",
      "contact_id": "64595845-34ec-482c-b0fe-ae617a0f8335",
      "created_at": "2026-06-18T10:00:00Z",
      "first_name": "John",
      "project_id": "spruce-demo",
      "company_name": "Acme Corp",
      "display_name": "John Doe",
      "billing_address": {
        "name": "Office",
        "address_one": "12 Marina Road",
        "city": "Lagos",
        "state": "Lagos",
        "country": "Nigeria",
        "country_code": "NG",
        "post_code": "100001",
        "phone": "+2348012345678"
      },
      "shipping_address": {
        "name": "Office",
        "address_one": "12 Marina Road",
        "city": "Lagos",
        "state": "Lagos",
        "country": "Nigeria",
        "country_code": "NG",
        "post_code": "100001",
        "phone": "+2348012345678"
      }
    },
    "approvals": [],
    "invoice_date": "2026-06-18T10:00:00Z",
    "due_date": "2026-07-18T10:00:00Z",
    "created_at": "2026-08-19T12:19:57.610806Z",
    "file_url": null,
    "journal_entry_id": null,
    "debit_account_id": null
  },
  "status": true,
  "message": "Successfully created invoice"
}

Creates an invoice. items is required. allow_post is optional; when true, the invoice is posted immediately after creation (the project must have allow_create_and_post enabled, otherwise the request is rejected with 400).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

identitystring

The identity for the active project.

Request

This endpoint expects an object.

customer_idstringRequiredformat: "uuid"

invoice_datedatetimeRequired

Must include exactly 3 fractional-second digits, e.g. 2025-12-29T18:00:00.000Z. Timestamps with no fractional seconds, or with a different digit count (e.g. microseconds), are rejected.

itemslist of objectsRequired

exchange_ratedoubleOptional

debit_account_idstringOptionalformat: "uuid"

sales_personnel_idstringOptionalformat: "uuid"

Sales personnel to credit for this invoice. Accepts either a ProfileSalesPersonnel id or a Contact id; if a Contact id is given and no sales-personnel record is linked to it yet, one is created automatically.

commissionobjectOptional

Per-invoice override of the workspace’s default commission terms.

order_idstringOptional

subjectstringOptional

due_datedatetimeOptional

Must include exactly 3 fractional-second digits, e.g. 2025-12-29T18:00:00.000Z. Timestamps with no fractional seconds, or with a different digit count (e.g. microseconds), are rejected.

reverse_chargebooleanOptional

adjustmentslist of objectsOptional

allow_postbooleanOptional

Response

Created

dataobject

statusboolean

messagestring