Create an invoice - HQ Rental Software

Creates a draft invoice for a contact, without lines.

What HQ sets. status draft, due_date (issued_on plus the account's invoice expiration days), currency (the account's default invoice currency when you do not send one), and the default notes and terms from Settings unless you send your own. For contact_type contacts, the contact's name, email and address are copied onto the invoice.

Side effects. The account's created invoice webhook fires.

Invoice custom fields can also be sent, keyed field_<id>.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "contact_type": "contacts",
    "contact_id": 30,
    "issued_on": "2026-10-06",
    "tax_id": 2,
    "currency": "usd",
    "po_number": "PO-7781",
    "item_type": "car_rental.reservations",
    "item_id": 1052,
    "enable_online_payments": false,
    "notes": "Thank you for your business.",
    "terms": "Payment due within 30 days."
}

Responses

🟢200OK

application/json

The new invoice under the invoice key. A successful body has no success field. HTTP 200 is also used for failures: such a body has success: false and is an ErrorUnauthorized (status_code 401 or 403).

Bodyapplication/json

Example

{
    "invoice": {
        "id": 1025,
        "invoice_number": null,
        "prefix": "INV-",
        "full_number": "DRAFT",
        "uuid": "9e3a61c4-0f7b-4d52-8b9e-5a2c7d1f6e08",
        "status": "draft",
        "type": "invoice",
        "issued_on": "2026-10-06T00:00:00.000000Z",
        "due_date": "2026-11-05T00:00:00.000000Z",
        "po_number": "PO-7781",
        "currency": "usd",
        "contact_type": "contacts",
        "contact_id": 30,
        "label": "Jane Doe",
        "first_name": "Jane",
        "last_name": "Doe",
        "email": "jane.doe@example.com",
        "tax_id": 2,
        "tax_name": "Sales tax",
        "subtotal": 0,
        "total_tax": 0,
        "total_amount": 0,
        "notes": "Thank you for your business.",
        "terms": "Payment due within 30 days.",
        "item_type": "car_rental.reservations",
        "item_id": 1052,
        "created_at": "2026-10-06T14:02:11.000000Z",
        "updated_at": "2026-10-06T14:02:11.000000Z"
    }
}

🟠422Parameter Error