Connect your HubSpot account to Goodweek to manage CRM contacts, companies, deals, and marketing data directly from your AI workspace.
ℹ️ Governance note
Goodweek will never exceed the access levels granted to the user within HubSpot, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.
📋 Prerequisites
Before any user can see and connect the HubSpot integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.
Admin Setup
The HubSpot integration uses OAuth 2.0. The user connecting must have HubSpot Super Admin permissions or App Marketplace Access. Standard users without these permissions will see the error "Vous ne disposez pas des autorisations nécessaires pour installer Composio" (or equivalent in your language).
How to grant App Marketplace Access in HubSpot
A HubSpot Super Admin can grant App Marketplace Access to a user without making them a Super Admin:
In HubSpot, go to Settings → Users & Teams.
Select the user, then go to Permissions.
Under Account, enable App Marketplace Access.
Click Save.
User Connection
In Goodweek, go to Integrations.
Find HubSpot and click Connect.
You will be redirected to HubSpot, where you will be asked to sign in and authorize access.
Click Connect app to grant access and return to Goodweek.
Important Notes
Each user must connect their own account individually.
Goodweek can only access the HubSpot data that your individual user account has permission to see. CRM records, pipelines, and marketing data visibility in Goodweek reflects your HubSpot permissions.
You can revoke Goodweek's access at any time from HubSpot → Settings → Integrations → Connected Apps → Composio → Uninstall.
Available Tools
Tool | Description | Type |
Get Account Information | Retrieves details about the connected HubSpot account including portal ID and settings. | Read |
Create Contact | Creates a new contact record in HubSpot CRM. | Write |
Archive Contact | Archives (soft-deletes) a HubSpot contact record. | Write |
Search Contacts | Searches HubSpot contacts using filters and property-based queries. | Read |
Batch Read Contacts | Retrieves multiple contact records by ID or unique property in a single request. | Read |
Create Company | Creates a new company record in HubSpot CRM. | Write |
Archive Company | Archives a HubSpot company record. | Write |
Search Companies | Searches HubSpot companies using filters and property-based queries. | Read |
Batch Read Companies by Properties | Retrieves multiple company records by properties in a single request. | Read |
Create Deal | Creates a new deal in a HubSpot sales pipeline. | Write |
Archive Deal | Archives a HubSpot deal record. | Write |
Search Deals | Searches HubSpot deals using filters and property-based queries. | Read |
Create Meeting | Creates a new meeting record associated with CRM contacts or companies. | Write |
Create Note | Creates a new note attached to a CRM record (contact, company, or deal). | Write |
Create Call | Creates a call log entry associated with a CRM record. | Write |
Create Task | Creates a new CRM task associated with a contact, company, or deal. | Write |
Add Asset Association | Creates an association between two HubSpot CRM objects (e.g., contact to company). | Write |
Get Pipeline by ID | Retrieves details for a specific HubSpot CRM pipeline. | Read |
Get Pipelines | Lists all pipelines for a specified CRM object type. | Read |
Get Pipeline Stage by ID | Retrieves details for a specific stage within a HubSpot pipeline. | Read |
Get All Marketing Emails | Lists all marketing emails for a HubSpot account. | Read |
Get Campaign | Retrieves details for a specific HubSpot marketing campaign. | Read |
Get Campaigns | Lists marketing campaigns in a HubSpot account. | Read |
Get Campaign Metrics | Retrieves engagement metrics for a specific HubSpot campaign. | Read |
Get Aggregated Statistics | Retrieves aggregated performance statistics across HubSpot marketing assets. | Read |
Get Revenue | Retrieves revenue data associated with deals in HubSpot. | Read |
Search CRM Objects | Searches across any HubSpot CRM object type using filters and property queries. | Read |
Archive Batch of Objects | Archives a batch of HubSpot CRM objects by ID in a single request. | Write |
Permanently Delete Contact (GDPR) | Permanently deletes a HubSpot contact for GDPR compliance. This action is irreversible. | ⚠️ Destructive |
Permanently Delete Company (GDPR) | Permanently deletes a HubSpot company record for GDPR compliance. This action is irreversible. | ⚠️ Destructive |
Delete Pipeline | Permanently deletes a HubSpot CRM pipeline. | ⚠️ Destructive |
Delete Marketing Email | Permanently deletes a HubSpot marketing email. | ⚠️ Destructive |
Use Cases
Create and update CRM records from conversations. Add new contacts, companies, or deals to HubSpot directly from a Goodweek conversation — including associations between records — without navigating the CRM.
Search and retrieve CRM data on demand. Query contacts, companies, or deals by property values from within Goodweek to surface specific records for review or follow-up without opening HubSpot.
Log meetings, calls, and notes against records. Capture a call log, meeting note, or task against a specific contact or deal directly from Goodweek after an interaction, keeping CRM records current.
Review pipeline and campaign performance. Retrieve pipeline stages, deal counts, campaign metrics, or revenue data from HubSpot within a Goodweek conversation to get a quick performance snapshot.
Troubleshooting
"You do not have the necessary permissions to install Composio" error
The user connecting does not have HubSpot Super Admin or App Marketplace Access permissions. A HubSpot Super Admin must grant App Marketplace Access as described in the Admin Setup section above.
Integration not visible in Goodweek
Make sure your organization admin has enabled the HubSpot integration from the Goodweek Admin Panel under the Integrations tab.