Connect HubSpot
Your Cord clients and quotes, up to date in HubSpot, without entering them twice.
What the integration does
- Every Cord client is created in HubSpot as a Company and, if it has an email or contact name, also as a Contact associated with that Company.
- Every sent quote is created as a Deal with its amount and currency, associated with the client’s Company and Contact.
- The Deal moves on its own: Cord updates its stage when the client opens the quote, approves it, rejects it, when it expires, is paid or invoiced.
- Contact corrections flow back to Cord: if you fix the Company name, or the Contact’s name, email or phone in HubSpot, they change in Cord too.
Field-by-field detail in What syncs.
Cord owns the sale status. Moving a Deal to another stage in HubSpot does not change the quote in Cord: its status is decided by the client’s approval and payment.
What flows and in which direction
| Direction | What flows | When |
|---|---|---|
| From Cord to HubSpot | Every client as a Company and Contact; every sent quote as a Deal, with its amount, currency and stage. | When the client is created or changed, and every time the quote moves forward. |
| From HubSpot to Cord | Corrections to the Company name, and to the Contact’s name, email and phone, only on records already linked to Cord. | When they are saved in HubSpot. |
| From HubSpot to Cord | Nothing else: moving a Deal to another stage or creating new Companies or Deals in HubSpot changes nothing in Cord. | — |
| From a workflow | A note on the Deal or the Company, with the Add a note in HubSpot action. | When the workflow runs. |
Field-by-field detail is in What syncs.
Before connecting
- In Cord: you need the Settings permission.
- In HubSpot: you need a user who can install apps in the account. If you do not have one, ask a HubSpot Super Admin to connect.
- One account per organization: a HubSpot account can only be connected to one Cord organization, and each Cord organization connects to a single HubSpot account.
- Currencies: if you quote in several currencies, enable them in your HubSpot account’s currency settings. A Deal in a currency HubSpot has not enabled cannot be created.
Connect step by step
- Open the app. Go to Settings › Integrations and tap HubSpot.
- Click Connect HubSpot. Cord takes you to HubSpot.
- Choose the HubSpot account, if you have several, and accept the permissions. You have 10 minutes to complete this; if it takes longer, click Connect again.
- Return to Cord. You see “HubSpot is connected.” and the Connected status, with the account name.
- Review the stages. In HubSpot stage for each quote status, confirm the pipeline and the stage for each status and click Save stages. If you use HubSpot’s default pipeline, Cord already suggests a stage for each status. See Pipeline and stages.
- Send what you already had (optional). In Existing data, click Send existing data to send your earlier clients and quotes. See What syncs.
From then on, every new or updated client and every quote that moves forward is sent automatically.
If the button does not take you to HubSpot or you come back to an error, click Connect HubSpot again from Cord. Do not reuse an old authorization link saved in your browser: every attempt creates a one-time link.
Permissions Cord requests
When authorizing, HubSpot shows the permissions Cord requests. Only what this integration needs:
| Permission | What for |
|---|---|
| Read and write Companies | Create each client’s Company and read name corrections. |
| Read and write Contacts | Create each client’s Contact, find existing ones by email and read corrections. |
| Read and write Deals | Create each quote’s Deal, move its stage and read your pipelines. |
Cord does not read your emails, calls, tickets, lists, forms or any other HubSpot object.
Connection messages
| Message | What happened | What to do |
|---|---|---|
| HubSpot is connected. | All good. | Review the stages. |
| You canceled the HubSpot connection. | You closed or declined the authorization in HubSpot. | Click Connect HubSpot again whenever you want. |
| The connection request expired or is not valid. Try again. | More than 10 minutes passed, an old link was used or it was opened from another session. | Click Connect HubSpot again from Cord. |
| That HubSpot account is already connected to another Cord organization. | The account is in use in another organization. | Disconnect it there or choose another account. |
| Couldn’t connect HubSpot. Try again. | HubSpot did not complete the authorization. | Try again; if it persists, write to contacto@cordhq.app. |
| You need Settings permission to connect integrations. | Your role lacks the Settings permission. | Ask the account owner to connect or grant you the permission. |
The connection panel
Once connected, the HubSpot page shows:
| Item | What it is |
|---|---|
| HubSpot account | The number and domain of the connected account. |
| Last sync | When something was last sent or received. “Not yet” if nothing has happened. |
| Queued | Pending sends. |
| Errors (7 days) | Sends that failed in the last week. |
| Last error | The most recent error message, if any. |
What to do with each error: HubSpot troubleshooting.
The Cord card inside HubSpot
This feature is new and may not be enabled on your account yet. If you do not see it, write to us.
With HubSpot connected, every Deal, Company and Contact shows the Cord card in its sidebar:
| Record | What it shows |
|---|---|
| Deal | The Cord quote linked to that Deal. |
| Company or Contact | The linked Cord client and their latest 8 quotes. |
Each quote shows number, status, amount with its currency, date and the client link, to copy or open it without leaving HubSpot. The Create quote in Cord button opens the Cord editor with that client already selected.
The card only reads: creating, editing or sending always happens in Cord, with your session. Cord checks that every request is signed by HubSpot and answers only with the data of the organization connected to that account.
If the card does not appear, open a Deal in HubSpot, click Customize in the sidebar and add the Cord card from Apps.
Switch to another HubSpot account
Disconnect the current account and connect the new one. When you connect a different account, Cord forgets the links to the previous account and resets the stage settings, because the other account’s pipelines do not exist in the new one. Then use Send existing data to populate the new account.
If you reconnect the same account, Cord keeps the links and your stage settings: Companies and Deals are not duplicated. Changes you made in Cord while disconnected were not sent; use Send existing data to catch up.
Disconnect
- In Settings › Integrations › HubSpot, click Disconnect.
- Confirm in Disconnect HubSpot?.
- You see “HubSpot disconnected”.
When you disconnect:
- Cord stops syncing and discards queued sends.
- Cord revokes its access to your HubSpot account.
- What is already in HubSpot is not deleted: Companies, Contacts, Deals and notes stay as they are.
- Workflows with the Add a note in HubSpot action start failing with “Connect HubSpot in Settings › Integrations to use this action.”
Limits
| Limit | Value |
|---|---|
| HubSpot accounts per organization | One, and each HubSpot account can only be in one Cord organization |
| Time to authorize in HubSpot | 10 minutes from when you click Connect HubSpot |
| Send existing data | Up to 500 clients and 500 sent quotes per run, up to 3 times per hour |
| Cord card on a Company or Contact | Its latest 8 quotes |
| Notes from workflows | 120 per hour per organization, up to 2,000 characters |
| Quotes without a currency or in a status without a stage | Not sent as a Deal: Cord never sends an amount without its currency |
Related
- What syncs
- Pipeline and stages
- HubSpot troubleshooting
- The invoice goes out when you get paid, a ready-made idea that, with HubSpot connected, leaves the note on the Deal