Setup guide

Verify Company

This guide walks through installing, configuring, using, disconnecting, and uninstalling the Verify Company HubSpot app. No sign-in is required to read this page.

What it does

Verify Company checks whether a HubSpot Company record's VAT or registration number is genuine, directly from a HubSpot workflow. It calls VIES, the EU's official VAT validation system, covering all 27 EU member states, and returns the verification status, VAT validity, and the company's officially registered name and address as workflow tokens you map onto the Company record.

Common use cases:

• Qualifying new leads by confirming they're a real, registered business before a rep spends time on them.
• Keeping existing Company records accurate by re-checking VAT/registration numbers periodically.
• Flagging mismatched or invalid VAT numbers for finance or compliance review.

1. Install the app

1. Go to the Verify Company page and click "Add to HubSpot" (or "Get started free").
2. You'll land on HubSpot's authorization screen, showing the account you're installing into and the permissions Verify Company requests (read access to Company records, and permission to create the properties it needs). Review them and click "Connect app".
3. You're redirected back once connected. Verify Company creates 5 Company properties automatically (verification status, VAT validity, company name, company address, verified date) — nothing to set up by hand before you start.

2. Configure the app

Verify Company doesn't need a separate setup step to work — once installed, both of its components are available right away:

1. Go to Automation → Workflows → create or edit a workflow, choose Company as the object, and add the "Verify Company" action.
2. Map the "Registration number / VAT ID" and "Country code" inputs on the action to the Company properties that hold that data.
3. Open Settings → Installed apps → Verify Company to see usage limits and the About / Setup guide / Subscription tabs.
4. There's no sync-direction or field-mapping setting beyond this — you map the action's output tokens onto whichever Company properties you want directly inside the workflow (see "Use the app" below).

3. Use the app

1. Add a "Set property value" step right after the "Verify Company" action, and map the action's output tokens (vies_verification_status, vies_vat_valid, vies_company_name, vies_company_address, vies_verified_at) onto the Company properties you want updated. This step is required — the action itself only produces workflow tokens.
2. Turn the workflow on. From then on, every Company that passes through it is checked against VIES automatically.
3. Add the "Company Verification Status" card to the Company record sidebar (open a Company record → sidebar "Settings" icon → "Add card" → search "Company Verification Status") to see the result at a glance without leaving the record.
4. Once the workflow has run on a Company, the card shows the verification status, VAT validity, and the company's registered name and address directly on the record.

4. Disconnect the app

Go to HubSpot Settings → Account Setup → Integrations → Connected apps, find Verify Company, and click "Disconnect".

Disconnecting stops the "Verify Company" workflow action and removes the Company Verification Status card from records. The Company properties Verify Company created, and any values already written into them, stay on your records — disconnecting the app does not delete any data.

5. Uninstall the app

Uninstalling removes Verify Company, including its workflow action and CRM card, from your HubSpot account. See HubSpot's general guide on removing an integration.

As with disconnecting, the Company properties already created and any values stored in them remain on your records after uninstalling; only the app's own functionality is removed.

Questions? Contact us at support@singleton-software.com.