One button, at the end of a job. When a job is invoiced in Rental HQ, Push to accounting creates the matching invoice in FreeAgent: the right contact, the lines of your invoice, and the VAT applied. It goes one way, and it goes once. What reaches FreeAgent is the same for all three packages, and is in the Accounting Overview.
What it does, and what it does not
The integration exists to stop you typing an invoice twice. You build the job in Rental HQ, you mark it invoiced, and the invoice appears in FreeAgent ready for you or your accountant.
- It writes invoices and the contacts on them. Nothing else is written to your FreeAgent account.
- It never emails your client. Sending the invoice to your client stays your decision, made in FreeAgent.
- It never records payments, deletes or cancels anything. Those stay in FreeAgent, where your bank feed already is.
- It is one way. Editing an invoice in FreeAgent does not change the job in Rental HQ, and editing the job afterwards does not change the invoice.
Connecting FreeAgent
Go to Settings → Integrations and choose Connect FreeAgent. You sign in at FreeAgent, not at Rental HQ, and approve the connection there. Rental HQ never sees your FreeAgent password.
FreeAgent gives Rental HQ the same access as the person who approves it, so approve it as a FreeAgent user who can create invoices and contacts. If the connection is ever refused for lack of permission, click Reconnect on the FreeAgent card and approve it as a user with more access.
Connect, Reconnect and Disconnect are shown to owners and administrators. If you use Rental HQ on the Mac, the same card is under Settings → Billing.
Choosing the income category
Every line on a FreeAgent invoice belongs to an income category, such as 001 Sales. After connecting, choose the category your invoices should post to from the list on the FreeAgent card. The list is read from your own FreeAgent account, including any categories you have added.
Until a category is chosen, a push is refused rather than guessed. A wrong category posts real income to the wrong place, and that is found by an accountant months later.
Drafts or sent
On the same card, choose how invoices arrive:
- Draft, the default: the invoice waits in FreeAgent for somebody to check it and send it.
- Sent: the invoice is marked as sent and goes into your accounts straight away. Marking it as sent does not email it to your client. You can still mark it back as a draft in FreeAgent.
If an invoice is created but FreeAgent will not mark it as sent, it is left as a draft and the confirmation says so: mark it as sent in FreeAgent. It is never raised a second time.
What lands in FreeAgent
- The contact: matched on the company name held against the job, or a person’s full name, including contacts you have hidden in FreeAgent. If nobody matches, a contact is created with the email, phone and address from the contact record. An existing contact is never renamed or merged. If you have more than 5,000 contacts, Rental HQ may not be able to look through them all; it then stops rather than risk a second copy of the client, and asks you to tell us.
- The lines of your Rental HQ invoice: the same lines in the same order, coming to the same total. Options the client did not take and alternatives they did not choose are left out; services such as transport go across, each service group as one line; a group or kit your invoice shows as one line goes as one line, with its description; and the section a line sits in is written after its name, for example Yamaha DXR12 Active Loudspeaker (PA: compact), 3 days at £45.00/day. A discount goes as a line of its own, as it appears in your invoice’s totals, and so does an agreed price for the services or the whole job; an agreed price for a group or for the equipment goes as one line at that price, naming what it covers. A replacement charge for lost kit goes as a line of its own, outside every deal. If you have sent the invoice from Rental HQ, the one your client received is the one that goes across. The Accounting Overview has the detail.
- The client’s reference: when the job has one (their purchase order number or budget code), it goes in FreeAgent’s PO reference, which prints on the invoice. The invoice’s own reference stays your Rental HQ invoice number.
- Discounts on a line: FreeAgent only has a discount for a whole invoice, so a line with a discount goes across at its price after the discount, or as its total with the quantity and the discount written into its description, whichever keeps FreeAgent’s figure the same as Rental HQ’s to the penny.
- The due date: worked out by FreeAgent from the payment terms the invoice was sent with: yours from Settings → Tax and terms, thirty days unless you have changed them, or the client’s own when Invoices due by the client’s own terms is on.
- The currency: your Rental HQ currency. FreeAgent keeps UK books, so a company in UAE dirhams connects Xero or QuickBooks instead.
- The invoice number: your Rental HQ invoice number, such as RHQ-2026-0001, so the reference your client pays with matches the invoice in FreeAgent. FreeAgent carries on counting from the last number it saw, so an invoice you raise directly in FreeAgent afterwards continues the sequence, as RHQ-2026-0002. If that takes a number a later job will want, the later job arrives with a suffix, as described under Pushing the same job twice.
VAT
The VAT rate comes from Settings → Tax and terms. If FreeAgent has your company as VAT registered, the rate is set on every line, so the total in FreeAgent matches the total in Rental HQ, and a line your invoice charges no VAT on is zero rated. FreeAgent works VAT out line by line, where Rental HQ works it on the total; if that ever lands a penny apart, the confirmation says so, and you can adjust it in FreeAgent before sending.
- If your rate in Rental HQ is zero and your FreeAgent company is VAT registered, the lines are zero rated. Otherwise FreeAgent would add VAT to UK clients on its own.
- If Rental HQ charges VAT but FreeAgent does not have your company as VAT registered, the push is refused rather than posted without it. Either set your tax rate to zero in Settings → Tax and terms, or check your VAT registration in FreeAgent.
If FreeAgent asks us to slow down
FreeAgent limits how many requests an app can make each minute. If a push meets that limit, Rental HQ waits a few seconds and tries again. If FreeAgent asks for a longer pause, the push stops and asks you to try again in a minute; nothing is sent twice.
Pushing the same job twice
Nothing happens twice. Rental HQ records the invoice it created, and a second push on the same job tells you the invoice is already in FreeAgent, with its number, and sends nothing. If the invoice is still on its way (pushed from the Mac a moment ago, say), a second push says so and sends nothing. A push that failed is not counted as done, so once you have fixed whatever it complained about, you can push again.
Deleted or cancelled it in FreeAgent? Push again and Rental HQ sends a fresh one. It asks FreeAgent first, and only an invoice that is deleted or cancelled there counts as gone. If FreeAgent cannot be asked, the push says so and sends nothing; try again in a moment.
FreeAgent uses each invoice number once, and a cancelled invoice keeps its number. So an invoice sent again while a cancelled one still holds its number arrives with a suffix, such as RHQ-2026-0001-2, and the confirmation tells you the new number. The same happens if an invoice raised directly in FreeAgent took the number first. If your client pays by reference, give them the new number.
If you send the client a new version of the invoice after pushing, the push does not send it on its own, because FreeAgent would then hold two invoices for one job. Pushing tells you which version was sent: cancel or delete the first invoice in FreeAgent, then push again. Rental HQ checks with FreeAgent that the first invoice is gone before it sends the new version; until it is, pushing again gives the same message and sends nothing.
Disconnecting
Disconnect on the FreeAgent card ends the connection and removes the stored authorisation. Invoices already in FreeAgent stay exactly where they are. If you revoke Rental HQ from inside FreeAgent instead, the next push will say so and ask you to reconnect: click Reconnect on the FreeAgent card.
Rental HQ keeps its record of which jobs it pushed, and the income category and draft setting on its card, when you disconnect. Connect the same FreeAgent company again and it carries on where it left off, unless a different company was connected in between. Connect a different company and choose its income category; jobs pushed to the old company are not counted as being in the new one. Rental HQ remembers one company for each job, so a job you pushed to the other company is remembered there; after switching back, check FreeAgent before pushing such a job again, as it would arrive a second time.
Connect one accounting package at a time. A push does not ask which set of books you meant, so with Xero, QuickBooks or FreeAgent connected together it is not predictable which one receives the invoice. If you are moving from one to another, disconnect the old one first.
What we hold. The authorisation from FreeAgent is encrypted before it is stored. Your FreeAgent password is never sent to Rental HQ, and no other company using Rental HQ can see anything about your connection or the invoices sent through it.