Key points
- Invoices, credit notes and sales receipts issued in Holded appear in HubSpot linked to the company and the deal, with number, total, PDF and payment status.
- Each payment in Holded updates paid and pending on the deal and the outstanding and overdue amounts on the company.
- If the HubSpot account has no Invoices object or the optional permission isn't accepted, the invoice data is stored on the deal instead.
- Every synced field sits in the “Holded” property group, so it works in lists, reports and workflows.
- Payments can also be recorded from HubSpot into the treasury account set in Settings or in a rule, and repeating the action doesn't duplicate the payment.
Why sales needs Holded invoice data in HubSpot
In many companies operating in Spain, finance works in Holded and the commercial team works in HubSpot, often in different languages and sometimes in different countries. Without a sync, every “has this customer paid?” turns into an email to finance, and every renewal call starts without knowing whether the last three invoices are overdue.
Bringing Holded invoices and payments into HubSpot solves three everyday problems:
- Credit control before selling more. An account manager can see the outstanding and overdue balance on the company before sending a new proposal.
- Better renewals and customer success. Recurring invoices, their monthly equivalent and the payment history sit on the company record, where customer success already works.
- Segments based on real purchases. Marketing can build lists from what customers were actually invoiced, not from what the CRM thinks they bought.
What appears where in HubSpot
With the “Invoices and payments” flow on, Holded by Vexco places each piece of data where the people who need it already look. The table summarises it.
| Where in HubSpot | What you see |
|---|---|
| Invoice records (HubSpot's Invoices object) | Each issued Holded invoice, with number, total, PDF and payment status, linked to the company and the deal. Credit notes and sales receipts arrive too. |
| Deal | “Invoiced (Holded)”, “Paid (Holded)”, “Payment date (Holded)” and what is still pending. On the deal's “Holded” tab: quoted, invoiced, paid and pending, with overdue amounts and each document's status. |
| Company and contact | “Outstanding (Holded)”, “Overdue (Holded)”, “Overdue invoices (Holded)”, “Invoiced last 12 months (Holded)” and “Last invoice date (Holded)”. |
| Company card | A chart of invoiced vs paid over 6, 12 or 24 months, the latest documents with days overdue, recurring invoices with their monthly equivalent, payment terms and a masked IBAN. |
| Order records (HubSpot's Orders object) | Sales orders, waybills and purchase orders from Holded, if you use the sales or purchasing flows. |
The full list of synced objects and directions is on the features page.
Invoices and Orders objects: the optional permissions
HubSpot's Invoices and Orders objects are not available in every account, and the app's permissions for them are optional during installation. That gives you two possible outcomes:
- The account has the objects and you accept the permissions: each Holded invoice becomes its own HubSpot invoice record, associated with the company and the deal, and orders become order records.
- The objects are missing or the permissions weren't accepted: the invoice data is stored on the deal itself, in properties of the “Holded” group, and the cards still show the documents.
Either way, the paid and pending amounts on the deal and the balance on the company are updated. The difference is whether you get separate invoice records you can report on one by one.
How fast invoices and payments arrive
Holded notifies the app when an invoice or a payment changes, so those changes are copied within seconds. A nightly pass checks for anything that was missed, for example while the Holded API was unavailable. Opening a card summary in HubSpot does not spend Holded API quota, because it uses data that is already synced; opening a document's details does query Holded.
For past invoices, use the initial load in step 6 of the setup wizard. You choose the date range and the document types, can start with a sample of 5 to 50 records, and see the estimated Holded API calls against your monthly quota before anything runs. Loads never touch the reserve kept for day-to-day syncing.
Reports and lists with the “Holded” properties
All the properties the app writes live in the “Holded” group on each object, so they behave like any other HubSpot property. A few examples teams set up in the first week:
- Overdue customers: a company list where “Overdue (Holded)” is greater than 0, shared with account managers and customer success.
- Reactivation campaign: companies whose “Last invoice date (Holded)” is more than six months ago, used by marketing for a win-back email.
- Revenue by owner: a report on “Invoiced last 12 months (Holded)” grouped by company owner, built from invoiced figures rather than deal amounts.
- Upsell filter: exclude companies with overdue invoices from upsell sequences, so nobody pitches a new service to a customer who owes money.
Workflows: “Get customer balance in Holded” and other actions
With the Advanced automation module, the app adds 21 actions to HubSpot workflows. For invoicing, the most useful are:
- Get customer balance in Holded: returns what the customer owes (pending and overdue), its overdue invoices and what was invoiced in the last 12 months, so the workflow can branch on it.
- Get Holded document status: returns status, number, totals, due date and days overdue of a deal's document.
- Get Holded document PDF: returns a link to the PDF to use in a later email step.
- Record payment in Holded: records a fixed amount, an amount from a property or everything pending.
A typical credit-control workflow looks like this:
- Trigger: a deal enters the “Proposal sent” stage.
- Action: “Get customer balance in Holded” on the deal's company.
- Branch: if the overdue amount is greater than 0, create a task for the account manager and notify finance.
- Otherwise, continue with the normal sales sequence.
Recording payments from HubSpot
Payments flow both ways. Besides bringing Holded payments into HubSpot, the app can record a payment in Holded from the deal card or a workflow. It goes to the treasury account chosen in Settings → Holded defaults, or to the one a rule sets: for example, if the company's payment method is “Cash”, use the “Cash box” account. Repeating the action doesn't duplicate the payment, and the app never deletes payments it didn't create.
If no treasury account is configured, payments from HubSpot fail and the activation summary warns you before go-live. The app never picks “the first account in the list” on your behalf.
What stays in Holded, on purpose
Bringing invoices into HubSpot does not mean copying the accounts. Some data stays in Holded by design, because it belongs to finance and has no use in a CRM:
- Accounting ledgers and the chart of accounts.
- Remittances and cash-flow forecasts.
- Payroll and time-clock records.
The app also keeps no copy of your CRM or of Holded on its own servers: it stores the IDs that link records, a summary of the last synced state to detect changes and conflicts, and the activity log. The security page explains where that data is stored and for how long.
How to set it up
The Invoicing bundle (€49 a month) covers the main use case: customers, catalog, the invoice when a deal is won, and invoices with payments back in HubSpot. In the wizard, choose the “Invoicing” template, review the fields and load the invoices you want from history. Plans and volumes are on the pricing page.
The next step most teams take is the opposite direction: creating the Holded invoice automatically when a HubSpot deal is won. If you want to see how an invoicing flow like this was designed for a real company, read Vexco's Holded–HubSpot integration case study.
Holded by Vexco
Install it from the HubSpot Marketplace, connect your Holded company and start in read-only mode. Nothing syncs until you switch it on.
Try it freeFrequently asked questions
Can I see Holded invoice PDFs in HubSpot?
Yes. Each invoice issued in Holded appears in HubSpot with its PDF, number, total and payment status, linked to the company and the deal. Credit notes and sales receipts are synced the same way.
Do payments sync in both directions?
Yes. Payments recorded in Holded update the deal and the company in HubSpot within seconds. From HubSpot, you can record a payment in Holded from the deal card or with the “Record payment in Holded” workflow action, into the treasury account from your settings or a rule.
Will the app change or delete my invoices in Holded?
No. Holded by Vexco never touches an issued invoice and never deletes payments it didn't create. Corrections to issued invoices go through a credit note, which you can create with the “Create credit note in Holded” action.
Do I need HubSpot's Invoices object?
No, but it helps. If your account has the Invoices object and you accept the optional permission, each Holded invoice becomes its own HubSpot record. If not, the invoice data is stored on the deal and the cards still show every document.
Can I bring in invoices issued before installing the app?
Yes. The initial load in step 6 of the setup wizard lets you choose the date range and document types to load. You can simulate it first, start with a sample and see the estimated Holded API calls before it runs.
Does checking a customer's balance use my Holded API quota?
No, not for card summaries. The company and deal cards use data that is already synced, so they don't spend Holded API calls. Opening a document's details does query Holded, and the app shows the calls used this month in the Connection tab.