Skip to main content
Apragya AIFree quotation builderQuotation builderQuote builderno signup
Integration guide

How to Connect HubSpot to Apragya With a Private App Token

For teams that keep marketing in HubSpot and run orders, stock and accounts in Apragya: connect the two safely and keep contacts and deals in step.

A sales manager shaking hands with a buyer in an HVAC showroom

To connect HubSpot to Apragya, create a private app in your HubSpot account, give it only the scopes you need, and paste its access token into a HubSpot connection. The test reads a single contact to prove the token works.

Many Indian SMEs keep HubSpot for marketing and move orders, GST invoicing and delivery into an ERP. The connection lets workflows keep HubSpot informed without anyone retyping.

Below are the steps, an illustrative example from Gurugram and the checks for the first week.

How to connect HubSpot to Apragya

In HubSpot, create a private app and grant only the CRM scopes your workflows need, for example contacts and deals. Copy the access token it generates.

In Apragya, add a HubSpot connection and paste the token. Run the test, which reads one contact. Then add HubSpot steps to a workflow, such as finding a contact by email or updating a deal.

  1. Create a private app in your HubSpot account.
  2. Grant only the scopes your workflows need.
  3. Copy the access token.
  4. Add the HubSpot connection in Apragya and paste it.
  5. Run the test, then add one workflow step.

What goes wrong without a clean connection

Duplicate contacts

The same buyer is created in both systems by hand.

Stale deal stages

HubSpot still shows a deal open after the order is placed.

Over-scoped tokens

A token that can change far more than the workflow needs.

Missing context

Sales cannot see that an invoice has been raised.

An example: a Gurugram HVAC equipment supplier

Take an illustrative supplier whose marketing team runs campaigns in HubSpot while sales orders, installation and invoicing run in Apragya. Marketing wanted to know which campaign leads became orders.

What the workflow keeps in step

Order workflow

Runs when a sales order is confirmed.

  • Find contact

    Looks up the buyer in HubSpot by email.

  • Create if missing

    Adds the contact when not found.

  • Update deal

    Moves the deal to the won stage.

  • Add a note

    Records the order value on the deal.

  • Call history

    Each call logged on the connection.

Marketing saw campaign leads turn into orders without asking sales.

Within a month, marketing could see which campaigns produced confirmed orders, and sales stopped updating deal stages twice. Two duplicate contacts turned up in the first week and were merged in HubSpot.

A central gear linked by threads to five small objects around it
One order workflow kept the contact, the deal and its note in step.

How the HubSpot private app token is used

Step 1 of 5

Private app

Create it in HubSpot and choose the CRM scopes you need.

  1. Private app: Create it in HubSpot and choose the CRM scopes you need.
  2. Token stored encrypted: Paste the access token into the connection; it is not shown again.
  3. Test: The test reads one contact to prove the token works.
  4. Workflow steps: Create, find and update contacts, create and update deals, add companies and notes.
  5. Call history: Each call is logged against the connection.

Choosing what to sync with HubSpot contacts and deals

Keep the direction simple. Let the system where work happens be the source for each fact: HubSpot for campaigns and early leads, Apragya for orders, invoices and delivery. Push only what the other side needs.

Retyping, against a HubSpot connection

FeatureRetyping between systemsApragya with HubSpot
New buyersCreated twiceFound first, created if missing
Deal stage after orderUpdated when rememberedUpdated by the workflow
Order contextAsked for on chatA note on the deal
Token scopeNot applicableOnly the scopes you grant

Checked against public information on 16 September 2026.

What sets this HubSpot API integration in India apart

GST after the deal

E-invoice, e-way bill and GSTR-1 on the order side.

One record in Apragya

Customer, order, delivery and invoice linked.

Agents with review

Agents can score or follow up leads, with people approving.

Access by role

Who can change the connection is controlled.

Errors explained

AI can explain a failed call in plain language.

Imports too

Contacts exported from HubSpot can be imported from a file.

Compare Apragya and HubSpot, and see deals.

First-week checks

  1. Confirm the test passes after any scope change.
  2. Check the call history for failed calls.
  3. Look for duplicate contacts in HubSpot.
  4. Agree which system owns each field.

Start with one workflow, such as the won-deal update, before adding more.

What it costs to start

Free
Up to 3 users
CRM, HR and Vendor Onboarding
INR 3,999
Starter, a month
Up to 10 users, CRM and HR plus a choice of apps
INR 7,999
Pro, a month
Up to 25 users and every enterprise app

Connecting HubSpot, answered

Which scopes should the private app have?
Only those your workflows use, such as reading and writing contacts and deals.
Does it bring all HubSpot records into Apragya?
The connection works per workflow call. For a bulk move, export contacts from HubSpot and import the file.
What happens if the token is rotated?
Paste the new token into the connection and run the test again.
Can we attach notes to companies as well?
Yes. Notes can be attached to a contact, deal or company.
What does it cost to start?
The free plan covers up to 3 users with CRM, HR and Vendor Onboarding and 1,000 AI Credits a month. Starter is INR 3,999 a month for up to 10 users, with CRM and HR plus a choice of apps such as Sales and POS, Inventory, Payroll, Purchase and Payables, Support and Manufacturing. Pro is INR 7,999 a month for up to 25 users with every enterprise app, including Finance and Accounting, plus 5,000 AI Credits, single sign-on and audit logs.

Keep HubSpot in step with your orders

Create a private app token, test it and add one won-deal workflow.