What the connection does
Crescendo connects to HubSpot using HubSpot OAuth. You do not paste a HubSpot API key into this setup flow. After HubSpot is connected, Crescendo can make HubSpot available to AI assistants for workflows you configure in Crescendo, such as:| HubSpot data | How Crescendo can use it |
|---|---|
| Contacts and contact properties | Read customer context and update contact data when configured |
| Tickets, ticket pipelines, and ticket statuses | Create or update support tickets for assistant handoffs |
| Conversations, inboxes, and custom channels | Route handoffs and sync conversation activity |
| Users and teams | Use HubSpot owner, author, and routing context |
| Files, content, and Help Center articles | Load HubSpot knowledge content for assistant answers |
Connect HubSpot
- Sign in to Crescendo.
- Open Settings > Applications.
- Click Install Application.
- Select HubSpot.

- In HubSpot, choose the HubSpot account you want to connect.
- Review the requested access on the OAuth approval screen.
- Click Connect app.
- After HubSpot redirects you back to Crescendo, confirm the HubSpot application card is enabled.


Configure account settings
After HubSpot is connected, open the HubSpot advanced settings in Crescendo when you need account-level options. To choose the HubSpot user shown on messages Crescendo sends to HubSpot threads:- Open Settings > Applications.
- Find the enabled HubSpot application card.
- Click Advanced settings.
- Select Thread Message Author from your HubSpot users.
- Save the setting.
Configure AI assistant use
Connecting HubSpot makes the account available to Crescendo. You still choose how each assistant uses HubSpot.Handoff and tickets
Use this when you want an assistant to escalate conversations into HubSpot.- Open the assistant in Crescendo.
- Open the assistant handoff settings.
- Enable HubSpot escalation.
- If you want Crescendo to create HubSpot tickets, enable HubSpot ticket creation.
- Select the HubSpot ticket pipeline and statuses that match your support workflow.
- Save and publish the assistant changes.
HubSpot conversations
Use this when you want assistant conversations to create or sync HubSpot conversation records.- Open the assistant in Crescendo.
- Open the assistant handoff settings.
- Enable automatic HubSpot conversation creation.
- If your workflow uses a specific HubSpot inbox, create a HubSpot channel account in Crescendo and select either the HubSpot Inbox or Help Desk inbox.
- Save and publish the assistant changes.
HubSpot email and form channels
Use this when you want a HubSpot email address or form to be handled by an AI assistant.- Open Settings > Emails in Crescendo.
- Add a new email channel or edit an existing one.
- Select HubSpot as the integration.
- Select the AI assistant that should handle the messages.
- Select Email or Form as the channel type.
- Select the HubSpot email address or HubSpot form.
- Select the sender email for assistant replies.
- Select the HubSpot ticket pipeline and the pending, escalation, and closed statuses.
- Save the channel configuration.
HubSpot Help Center knowledge
Use this when you want an assistant to answer from HubSpot Help Center content.- Open the assistant knowledge settings in Crescendo.
- Enable HubSpot Help Center Data.
- Select the Help Centers, languages, and tags you want the assistant to use.
- Load or reload the HubSpot content.
- Save and publish the assistant changes.
Use the integration
Your customer-facing assistant continues to run in Crescendo. HubSpot acts as a connected system that Crescendo can read from or write to based on your assistant configuration. Common uses include:- Answering questions from HubSpot Help Center content
- Using HubSpot contact context during a conversation
- Creating HubSpot tickets when an assistant escalates to your team
- Creating HubSpot conversations for assistant handoffs
- Handling HubSpot email or form submissions with an AI assistant
- Keeping HubSpot ticket and conversation activity tied to the Crescendo conversation
Disconnect or uninstall
To stop an individual assistant from using HubSpot, turn off the HubSpot options in that assistant’s handoff and knowledge settings, then publish the assistant. To remove Crescendo’s account-level access to HubSpot, remove the Crescendo connected app from HubSpot’s connected apps settings or contact Crescendo support. After disconnecting or uninstalling:- Crescendo cannot make new HubSpot requests until HubSpot is connected again.
- Existing HubSpot contacts, tickets, conversations, and content created or updated before disconnecting remain in HubSpot unless you remove them in HubSpot.
- Existing Crescendo assistant configuration remains in Crescendo, but HubSpot-dependent actions will not run until the connection is restored.

