Developer docs

    Everything you need to connect an app to HelloLedger. New here? Start with the quickstart.

    Get started

    QuickstartCreate a key, then send your first customer, invoice, and payment to HelloLedger in about ten minutes.AuthenticationSend your key as a Bearer token. Keys are limited to the companies and scopes you choose.Managing keysCreate, rotate, and revoke developer keys, and see what each key has done.ScopesEvery scope a key can hold and which routes it unlocks.

    Concepts

    External IDs and idempotencyAddress records by your own IDs. Retrying a request never creates a duplicate.ErrorsEvery error has a stable code, a message, an optional hint, and a request ID.Rate limitsPer-key limits, the headers that report them, and how to back off.

    Receivables

    CustomersOne customer per person or account you bill, addressed by your own ID.InvoicesEvery charge is its own invoice, posted to the ledger immediately and never emailed by HelloLedger.Customer paymentsRecord each payment on its own and apply it to the invoices it paid. No lumped deposits.Customer creditsSpecials, write-offs, and kept deposits, applied to the charges they cover.Customer refundsMoney back to a resident: deposit returns, overpayments, and leftover credits.Payouts and processor feesRecord each card or ACH payout so its fees land in the books.Products and servicesThe catalog your invoice lines use. Each item carries its income account.

    Bookkeeping

    How bookkeeping records workBills, expenses, journal entries, and invoices addressed by HelloLedger ID: drafts, posting, voiding, and safe retries.VendorsThe people and companies the business pays. Bills and expenses point at a vendor.BillsBills from vendors. Posting puts the expense on the books and the amount owed in Accounts Payable.Vendor creditsCredit memos from vendors: apply them to open bills, or record the cash refund.ExpensesMoney the company already spent by bank, card, or cash: receipts, card charges, and direct debits.Card creditsMoney a card gave back: merchant refunds and statement credits such as cashback or a won dispute.Journal entriesBalanced debits and credits for adjustments, accruals, transfers, and anything without its own form.Invoices by HelloLedger IDCreate invoices as drafts or posted, then edit, post, void, or delete them by invoice_id.Review queueBank and card transactions waiting for review, with the category HelloLedger suggests.Hotel statistics and KPIsSend daily rooms available and rooms sold; read occupancy, ADR, and RevPAR.

    Partners

    Connect HelloLedgerLet your users connect their HelloLedger company from inside your app. Nobody copies or pastes a key.Partner companies and billingSee which companies are connected to your app and who pays for each one.Becoming a partnerWhat to send HelloLedger, what you get back, and how to go live.

    More endpoints

    Daily revenue journalsPost one balanced journal per day from a point of sale or booking system.Reports and readsRead the chart of accounts, financial reports, A/R aging, invoices, and journal entries.AI assistants (MCP and GPT)Connect ChatGPT, Claude, Gemini, or Muse to HelloLedger with an assistant key.

    Guides

    Rent and property managementSync residents, every charge, and every payment from a property management app into HelloLedger.