Clients
Manage the people and organizations you invoice
Clients are the "billed to" side of every invoice. Before you can send an invoice, you need at least one client with an email address.
The clients page is at app.looped.sh/invoices/clients.
Anatomy of a client
| Field | Required? | Used for |
|---|---|---|
| Name | Yes | "Billed to" on documents. Unique per company (case-insensitive) |
| Client code | optional | Your account code for the client, such as ABELIA. Shows in the client list, pickers, statements, reports and on documents |
| Yes | Sending invoices and quotes by email | |
| Phone | optional | Shown on documents for contact |
| VAT number | optional | Shown on documents where it's required |
| Address | Yes | "Billed to" address: line 1 and postal code at least. The client list says No address when there isn't one |
| Delivery address | optional | Ship-to address, if different |
| Category and Own price level | optional | Which price level the client buys at |
| Sales code | optional | The sales rep the client's quotes and invoices are credited to |
A client can be a person (Jane Doe) or a business (Acme Corp). Looped doesn't distinguish.
Creating a client
Two ways:
From the clients page
- Open Clients in the Invoices nav.
- Click Add Client.
- Fill the form and Save.
From a quote or invoice
When the client doesn't exist yet, choose New client in the client picker on a quote or invoice. A modal opens to create them without leaving the document.
The client is saved, becomes the invoice's "billed to", and shows up on the clients page going forward.
Editing a client
Open the client row → Edit (or just click on the client). Change anything except the name (which stays unique per company).
Changes affect future invoices only. An invoice already sent retains the client snapshot it had at send time.
Deleting a client
If a client has no invoices, Delete removes the row.
If they have invoices, deletion is blocked — you'll see a warning. Either:
- Keep the client around (it doesn't cost anything), or
- Delete or void the invoices first, then delete the client
This safeguard prevents orphaning invoices that reference a client that no longer exists.
Searching
The clients page has a search bar that matches the client code, name, email, phone and VAT number. Every word you type has to match, in any order. Choose 25, 50 or 100 clients a page.
Pickers on documents show each client as "CODE · Name" and search by either.
The client page
Click a client to open their page: their Balance (or In credit), their documents, and the prices they pay.
Prices for a client
If your company uses Inventory, Prices for this client lists the items the client has their own price for, and All items shows every item at the price they pay now and where it comes from: Their list (their own price level), Category list (their category's level) or Item price (the item's own selling price). Search every item by name or code, then type a price under Their price for the exceptions.
To give the client a printable list of their prices, start a client price list from their page.
Why does each client need an email?
The send action needs somewhere to send the email to. The send button on an invoice is disabled if its client has no email — the tooltip explains why.
If you only ever invoice in person and don't need email sends, that's fine — leave the email blank, save the invoice, and download the PDF manually. But the bulk of the value comes from email + the Pay portal which requires the email.
Importing clients
Bulk import isn't built yet. Until then:
- Add them one at a time, or
- Use the Public API (
POST /v1/invoices/clients) to script imports from your CRM
Are you an AI? Visit llms.txt — these docs as plain markdown.