Key points
- Holded's own HubSpot page describes a connection through Zapier, with templates in both directions for contacts, companies and deals.
- Holded by Vexco installs from the HubSpot App Marketplace through OAuth and needs a Holded API key created in Holded → Settings → Developers.
- Nothing syncs until step 7 of the setup wizard, and you can start read-only (Holded → HubSpot only) before letting the app write to Holded.
- Changes that arrive by webhook are copied within seconds; Holded CRM opportunities, events and projects are checked every few minutes, with a nightly pass as a safety net.
Three ways to connect Holded and HubSpot
Holded is a Spanish ERP and invoicing tool used by many SMEs; HubSpot is where sales, marketing and service teams work. Neither vendor ships a built-in connector for the other, so there are three practical routes. Each one fits a different level of need, and the right answer depends on how many processes have to cross between the two systems.
| Route | What it does well | What you take on |
|---|---|---|
| Zapier or Make | Quick one-way automations from templates. Holded lists Zapier templates for contacts, companies, deals and Holded CRM opportunities. | Polling intervals (15 minutes on Zapier Free), paid plans for multi-step Zaps, no transfer of Holded custom fields, and duplicate handling you build yourself. |
| Marketplace app (for example Holded by Vexco) | A packaged two-way sync: customers, catalog, estimates, orders, invoices, payments, Holded CRM and projects, with matching by tax ID and email. | A monthly subscription by module, and working within what the app covers. |
| Custom integration | Anything you can specify: custom objects, multi-entity logic, special payment flows. | Build time, hosting, monitoring and maintenance whenever either API changes. |
If you only need one simple flow, such as sending new HubSpot form contacts to Holded, our article on connecting Holded and HubSpot with Zapier or Make covers it in detail. For a side-by-side view, see Holded by Vexco vs Zapier and Make and Holded by Vexco vs a custom integration. The rest of this guide focuses on the app route.
Before you start: what you need
Check these points before you install anything. Most delays in a Holded–HubSpot project come from permissions and data, not from the software.
- A HubSpot account. Any edition can install the app, and a super admin has to do it. HubSpot workflows, and therefore the app's 21 workflow actions, need a HubSpot Professional or Enterprise subscription.
- A Holded account with API access. You create the key in Holded → Settings → Developers → New API key. Holded shows the key only once, so paste it straight into the app. Give it the permissions for the modules you plan to use.
- A view of your Holded API quota. Holded allows 100 requests per minute per API key and has a monthly quota visible in your Holded account. The app shows the calls it uses and keeps a reserve for day-to-day syncing.
- A decision on who owns what. Usually Holded is the master for the catalog, invoices and payments, and HubSpot for deals and marketing data. Agree this with finance before you turn anything on.
- Reasonably clean tax IDs. Matching relies on the tax ID (NIF/CIF) and email. Our guide to avoiding duplicate contacts between Holded and HubSpot explains what to tidy first.
For companies with international teams, one detail matters: each HubSpot user sees the app in their own HubSpot language, Spanish if their HubSpot is in Spanish and English otherwise. Your finance team in Barcelona and your account managers in London can work on the same records, each in their own language.
Install the app from the HubSpot Marketplace
Open the Holded by Vexco listing in the HubSpot App Marketplace or use the install link. HubSpot asks a super admin to approve the app's permissions through OAuth. The permissions for HubSpot's Invoices and Orders objects and for workflow automation are optional: if you don't accept them, invoices and orders are stored on the deal instead of as separate records, and the workflow actions are not available.
Holded by Vexco is not an official Holded or HubSpot product. It is built and run by Vexco Solutions, a HubSpot partner agency based in Sabadell (Barcelona). Data is stored in the EU, and keys and tokens are encrypted at rest; the security page has the details.
The seven steps of the setup wizard
After installation, the app opens a wizard. It saves your progress, so you can close it and resume later. Nothing syncs until the last step.
- Connect Holded. Paste the API key. The app validates it immediately and shows which modules its permissions allow. You can connect several Holded companies; the first one is the default.
- Plan and modules. Choose a bundle or build your own by module, and how many Holded companies you need. What isn't in the plan doesn't sync. You start with a 14-day free trial with everything on and no card until it ends. The pricing page lists the bundles.
- Template. Pick “Commercial”, “Invoicing”, “Complete” or “Custom” as a starting point. Re-applying a template turns flows on or off but never deletes your edits.
- Review fields. See every field of every flow, its direction and how it's calculated. The app checks that each field fits the destination type and blocks “Next” if a flow has errors.
- Duplicates. “Analyze duplicates” compares both systems without writing anything and tells you how many records will be linked, created on each side or need a decision.
- Initial load. Decide which existing data to load and how: “Link only”, “Link and fill gaps” or “Full load”. You can start with a sample or run “Simulate without writing” first.
- Activate. Review the summary and the warnings about missing configuration, then tick “Start read-only (Holded → HubSpot only)” if you want and click “Activate sync”.
Each step is explained with screenshots in how Holded by Vexco works; the duplicate analysis is in step 5 and activation in step 7.
Start read-only, then turn on both directions
Read-only mode brings Holded data into HubSpot but writes nothing to Holded. Companies, contacts, products, invoices and payments appear in HubSpot, and the deal's “Holded” tab says “View only” and hides everything that writes. It is the safest way to check the data with real records before anything reaches your invoicing system.
Once both directions are on, changes that arrive by webhook are copied within seconds. Holded sends no notifications for CRM opportunities, calendar events or projects, so the app checks those every few minutes. A nightly pass catches anything that was missed.
What to check after activating
Go-live is not the end of the setup. Run through this list in the first week:
- Status tab. Health should be green. Check the last successful sync, failed jobs and the initial loads panel. “Pause all” stops everything without losing changes.
- Review inbox. Doubtful matches wait here with the buttons “Merge”, “Create new” and “Ignore”. Clear it before you turn on both directions.
- Activity log. Every sync and every user action is recorded, with field-by-field before and after values and links to both systems.
- Cards on record views. Add the app cards in HubSpot. On companies and contacts: Customize → “+” → Card library → filter “Apps” → “Holded” → Add. On products, add “Holded · Stock”. In the company and contact preview panel you can add “Holded · Info”, with outstanding and overdue amounts. On deals, create a “Holded” tab and add “Holded by Vexco”.
- Holded defaults. Under Settings → Holded defaults, choose the numbering series per document type and the treasury account. Without them, documents are not created and payments from HubSpot fail, and the app tells you why.
- A test deal. Win a deal in a test pipeline and check the draft that appears in Holded. Our article on creating the Holded invoice from a won HubSpot deal explains each setting.
Which route should you choose?
Use Zapier or Make when you need one or two simple, one-way flows and already pay for one of those tools. Use a Marketplace app when sales needs to see invoices, payments and balances in HubSpot and finance wants documents created in Holded without retyping. Go custom when your process has rules no packaged app covers.
Vexco Solutions works on both sides: the app covers the standard Holded–HubSpot process, and the team also builds custom HubSpot integrations when a project needs more. You can read how a real project was approached in the Holded–HubSpot integration case study, or follow the detailed setup guide when you are ready to install.
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
Does Holded have a native HubSpot integration?
No. Holded's own HubSpot page describes connecting the two through Zapier, and HubSpot doesn't build a Holded connector itself. Partner-built apps, such as Holded by Vexco, are available in the HubSpot App Marketplace and connect the two systems directly through their APIs.
Which HubSpot subscription do I need to connect Holded?
Any HubSpot edition can install Holded by Vexco, and a super admin has to approve it. The sync, cards and properties work on every edition. HubSpot workflows, and so the app's 21 workflow actions, need a Professional or Enterprise subscription.
Can my English-speaking team use the app?
Yes. Each HubSpot user sees the app in their own HubSpot language: Spanish if their HubSpot is in Spanish, English otherwise. The language of the texts the app writes, such as document notes and alert emails, is set separately under Settings → General.
Can I connect more than one Holded company?
Yes. You can connect several Holded companies to one HubSpot account; the first one is the default and each has its own series and accounts. Each extra company costs €12 a month, and the trial allows up to three.
Where is the data stored?
In the EU. Holded by Vexco runs on Cloudflare Workers, with its database and queues created in Cloudflare's EU jurisdiction. It keeps no copy of your CRM: only the IDs linking records, a summary of the last synced state and the activity log.
What happens when the free trial ends?
If you don't subscribe, sync is paused and nothing is deleted. You can subscribe at any time from the app's Plan tab and it picks up where it left off.