Setup Guide

How to setup UKPostcode’s HubSpot App:

  1. Click here to install the HubSpot application
  2. Purchase a Subscription Here

After you’re subscription is live, be sure to complete the rest of your account information here:

Complete Profile Information

How to use the postcode lookup feature:

  1. (see video below) Visit a contact record and click Simple Postcode Lookup
  2. (see video below) Search a postcode and select the relevant address, click copy all and then save.

Using the postcode lookup on Deals

HubSpot deals have no built-in address fields, so there are three one-off steps:

  1. Grant deal access. If you installed the app before October 2026, a HubSpot super admin needs to reconnect the app once and tick the deal permissions.
    If the deal permissions show a padlock (“This permission is disabled for this app by an admin”), your HubSpot account uses app approvals. A Super Admin needs to go to Settings → Integrations → Connected Apps → Approved apps, open Simple Postcode Address Search, click Manage access, switch on the deal permissions under Data Permissions → Optional (or click Enable all), save, and then reconnect again.
  2. Create deal address properties. In HubSpot go to Settings → Properties → Deal properties and create single-line text properties labelled Address, Address 2, City, County and Postcode. To use deal properties you already have (for example a delivery address your ERP reads), enter their internal names under HubSpot Deal Address Fields on your UKPostcodes profile instead.
  3. Add the card to deals. Open any deal, click Customise record → Right sidebar → Add card and choose Postcode Lookup.

Then click Search Postcode on a deal, select the address and click Save to HubSpot.

Setup Guide

Set up UK postcode lookup in HubSpot

Connect the app to your HubSpot portal, map your address fields, and start saving accurate UK addresses in a few minutes. Here is the full walkthrough.

Step-by-step

1

Install from HubSpot

Click Install on HubSpot, choose the portal you want to connect, and approve the requested CRM scopes. You are redirected back to UKPostcodes when the connection is complete.

2

Start your subscription

Pick the £19/month plan and complete checkout. One subscription covers your whole portal with unlimited searches and unlimited users.

3

Complete your profile

Open your profile to confirm which HubSpot properties each address field maps to - building, street, town, county and postcode.

4

Look up an address

Open any contact, company or deal, click the Simple Postcode Lookup card, search a postcode, pick the match and save.

Mapping your address fields

Each lookup returns the building/sub-building, street, town/locality, county and postcode. Map these to the HubSpot properties you already use - or create custom properties - so the data lands exactly where your reports and workflows expect it.

Royal Mail PAF accuracy

Addresses come from Royal Mail Postcode Address File data, so every saved record is accurate and deliverable - improving mail delivery, segmentation and reporting across your CRM.

Setup FAQs

Which HubSpot permissions (scopes) are required?
The app needs read and write access to contacts and companies so it can read the record you are on and write the selected address back. Read and write access to deals is optional and only needed to save addresses on deals. No other data is accessed.
Can I change which HubSpot fields the address is saved to?
Yes. In your UKPostcodes profile you can map each part of the address (building, street, town, county, postcode) to any standard or custom HubSpot property, with a separate mapping for deal properties.
How do I use the lookup on deals?
Add the card to the deal record sidebar in HubSpot, create the deal properties you want to fill (for example address, city and postcode), and map them in your UKPostcodes profile. If you installed before deal support was added, reconnect the app once to grant deal access.
The deal permissions show a padlock - what do I do?
The message "This permission is disabled for this app by an admin" means your HubSpot account uses app approvals. A Super Admin needs to open Settings, Integrations, Connected Apps, Approved apps, select Simple Postcode Address Search, click Manage access and switch on the deal permissions under Data Permissions (or click Enable all). Then reconnect the app and tick the deal permissions.
The lookup card is not showing on my record - what do I check?
Make sure the install completed for the correct portal, that your subscription is active, and that the card has been added to the record sidebar for contacts, companies or deals. A quick page refresh in HubSpot usually surfaces a newly installed card.
Do I need to install it for each user?
No. Install once per HubSpot portal and every team member can use it - there are no per-seat charges.

Ready to go?

Install the app and start saving accurate UK addresses to HubSpot.

Install on HubSpot View on HubSpot