Acitinar
    How It WorksWho It's For
    PricingContact
    Sign InStart Free Trial
    Acitinar

    Turning business signals into commercial opportunities — helping you contact the right companies at the right time.

    Signals
    • Commercial Intelligence
    • Buying Signals
    • Sales Intelligence
    • Business Signals
    Use Case
    • Recruitment
    • Agencies
    • Accountants
    • Corporate Finance
    • Professional Services
    • Business Development Teams
    Company
    • Home
    • About Us
    • Blog
    • Documentation
    • Sitemap
    • Contact
    Legal
    • Privacy Policy
    • Terms of Service
    • Cookie Policy
    • Acceptable Use Policy
    • Data Processing Addendum
    • AI & Signals Disclaimer
    • Website Disclaimer

    © 2026 Acitinar. All rights reserved.

    Back to Documentation

    Connecting HubSpot to Acitinar

    A walkthrough for creating a HubSpot private app and linking it to your Acitinar account — captured from a real setup, screenshots included.

    What gets synced

    Once connected, clicking Sync Now creates or updates, per unlocked company: a Company, Contact records for employees with a verified email on file, and a Deal. Re-running a sync updates the same records rather than duplicating them — Companies are matched by UK company number, Contacts by email, and Deals by a hidden reference Acitinar creates automatically the first time you sync.

    Every synced Company carries name, website, address, industry, founded year, annual revenue, and employee count. Checking "Include Sales Intelligence" before syncing also pushes company state, outreach angle, pain points, and likely priorities — the AI-generated sales summary for that company, drawn from whichever version of the brief your subscription currently gives you access to.

    Before you start

    Unlike Salesforce, there's no OAuth redirect here — HubSpot's Private Apps use a single access token you copy and paste. You'll need HubSpot admin access and about five minutes.

    1Create a private app

    In HubSpot, go to Settings → Integrations → Private Apps(HubSpot may route this through a "Legacy Apps" page first — that's expected, private apps still work exactly the same way). Click Create a private app, name it something you'll recognize, like Acitinar.

    app.hubspot.com/private-apps/<hub-id>
    HubSpot Legacy Apps list showing a newly created private app alongside an existing one
    A new private app shows up alongside any others already in your account — this one and your production integration can coexist.

    2Add the required scopes

    On the Scopes tab, search for and check each of these — all twelve are required. Missing any of the crm.schemas.*.write scopes silently blocks dedup, so re-syncing creates duplicates instead of updating:

    crm.objects.companies.readcrm.objects.companies.writecrm.objects.contacts.readcrm.objects.contacts.writecrm.objects.deals.readcrm.objects.deals.writecrm.schemas.companies.readcrm.schemas.companies.writecrm.schemas.contacts.readcrm.schemas.contacts.writecrm.schemas.deals.readcrm.schemas.deals.write

    Click Create app once all twelve are selected, then confirm in the dialog that follows.

    3Copy the access token

    On the app's Auth tab, click Show tokennext to Access token and copy it — this is what goes into Acitinar, not the Client secret below it (that's only used for signature validation, and Acitinar doesn't need it).

    app.hubspot.com/private-apps/<hub-id>/<app-id>/auth
    HubSpot Auth tab showing masked access token and client secret, plus all 12 selected scopes
    All 12 scopes confirmed selected, token and secret masked by default — click "Show token" to reveal the access token when you're ready to copy it.

    Treat it like a password

    Anyone with this token can read and write your HubSpot CRM data. Only paste it into Acitinar's own connect form — never into a spreadsheet, chat message, or public repo.

    4Watch the full setup

    Naming the app, selecting all 12 scopes, creating it, and the masked Auth tab, captured end to end:

    Animated walkthrough of creating a HubSpot private app

    5Connect in Acitinar

    In your Acitinar dashboard, go to Settings → Integrations and open the HubSpot card. Paste the access token in and click Connect— Acitinar verifies it immediately by making a live call to HubSpot, so you'll know right away if it's valid.

    Unlike Salesforce, that's the entire connection step — no redirect, no separate login screen. The custom properties Acitinar needs — UK company number, company status, SIC code, funding info, and the Sales Intelligence fields — are created automatically on Companies, Contacts, and Deals in your HubSpot account the first time you sync, as long as the scopes above are in place.

    Confirm it worked

    Once connected, the card should read Connected:

    app.acitinar.com/dashboard/settings?tab=integrations
    Acitinar Settings page showing both HubSpot and Salesforce cards marked Connected
    Both CRMs can be connected independently — each has its own card, its own "Last synced" timestamp, and its own Sync Now button.

    From here, click Sync Now whenever you want to push your latest unlocked companies. Check "Include Sales Intelligence" first if you also want company state, outreach angle, pain points, and likely priorities pushed as custom properties too.

    How syncing works

    • Sync is manual — click Sync Now whenever you want to push your latest unlocked companies.
    • Re-running a sync updates existing records rather than creating duplicates. If a rep has manually moved a Deal to a different stage in HubSpot, re-syncing never overwrites that stage — only newly-created Deals get their initial stage set by Acitinar.
    • The "Last synced" timestamp on the card shows when you last ran a sync.
    • Disconnecting HubSpot stops future syncs but doesn't delete anything already created there.

    Troubleshooting

    SymptomLikely cause
    Companies sync but Contacts/Deals don't appearThe token is missing one of the crm.objects.contacts.* / crm.objects.deals.* / crm.schemas.*.write scopes — check the Auth tab's scope list.
    "Invalid HubSpot API token" when connectingThe token was copied with a trailing space, partially copied, or the app was deleted/rotated after copying — go back to the Auth tab and copy it fresh.
    Re-syncing creates duplicate Companies instead of updatingOne of the required scopes wasn't in place on your first sync — fix the scopes, then sync again; matching resumes correctly.
    Connection stops working after rotating the tokenRotating a token in HubSpot invalidates the old one immediately — you'll need to reconnect in Acitinar with the new token.

    Common questions