Connect your own HubSpot portal(s) to manage your CRM and marketing data from Imperal -- contacts, companies, deals, tickets, products and line items with full CRUD, batch operations and search; associations between records; custom properties; pipelines and stages; owners; engagements (notes, calls, emails, meetings, tasks); marketing lists and form submissions; files; custom objects; webhook subscriptions; plus value-add reports like pipeline health and duplicate-contact detection. Uses your own HubSpot Private App access token -- nothing is hosted or proxied by Imperal beyond the request itself. Note: Quotes, Workflows automation, CMS Hub (sites/pages/blogs) and the Conversations inbox are out of scope -- different products/domains within HubSpot.
connect_hubspotwriteConnect a HubSpot portal by saving a Private App access token, after checking it actually works. Create the Private App in your HubSpot portal: Settings > Integrations > Private Apps > Create a private app, grant it the CRM/Marketing/Files scopes you plan to use, then copy its Access token here. Non-expiring; you rotate it yourself in HubSpot if needed.
disconnect_hubspotwriteDisconnect a connected HubSpot portal. This does not revoke the Private App token in HubSpot itself -- revoke/delete it there too if you no longer want it valid.
list_connectionsreadList the connected HubSpot portals -- portal id, domain, and label.
list_objectsreadList CRM records of any object type (contacts, companies, deals, tickets, products, line_items, or a custom object). Use list_contacts/list_companies/... for the standard types; use this for custom objects.
get_objectreadRead one CRM record of any object type in full.
create_objectwriteCreate a new CRM record of any object type.
update_objectwriteUpdate an existing CRM record's properties (any object type). Omitted properties are left untouched.
archive_objectwriteArchive (soft-delete) a CRM record of any object type. Recoverable from the portal's recycling bin for 90 days.
list_contactsreadList contact records.
get_contactreadRead one contact in full. Set id_property='email' to look up by email instead of internal id.
create_contactwriteCreate a new contact record.
update_contactwriteUpdate an existing contact's properties.
archive_contactwriteArchive (soft-delete) a contact.
list_companiesreadList company records.
get_companyreadRead one company in full.
create_companywriteCreate a new company record.
update_companywriteUpdate an existing company's properties.
archive_companywriteArchive (soft-delete) a company.
list_dealsreadList deal records with their stage, amount, and pipeline.
get_dealreadRead one deal in full -- stage, amount, close date, pipeline.
create_dealwriteCreate a new deal record.
update_dealwriteUpdate an existing deal's properties (e.g. move it to a new stage).
archive_dealwriteArchive (soft-delete) a deal.
list_ticketsreadList support ticket records.
get_ticketreadRead one support ticket in full.
create_ticketwriteCreate a new support ticket.
update_ticketwriteUpdate an existing ticket's properties (e.g. status, priority).
archive_ticketwriteArchive (soft-delete) a support ticket.
list_productsreadList product catalog records.
get_productreadRead one product catalog record in full.
create_productwriteCreate a new product catalog record.
update_productwriteUpdate an existing product's properties (name, price, description).
archive_productwriteArchive (soft-delete) a product catalog record.
list_line_itemsreadList line-item records (individual products attached to a deal).
get_line_itemreadRead one line item in full.
create_line_itemwriteCreate a new line item (attach it to a deal afterwards via associate_objects).
update_line_itemwriteUpdate an existing line item's properties (quantity, price).
archive_line_itemwriteArchive (soft-delete) a line item.
search_objectsreadSearch CRM records of any object type with filters, sorting and free-text query -- the CRM Search API. Use this instead of list_objects when you need to filter (e.g. deals above a certain amount, contacts created after a date).
batch_read_objectsreadRead up to 100 CRM records of one object type by id (or by a unique property like email) in a single call.
batch_create_objectswriteCreate up to 100 CRM records of one object type in a single call.
batch_update_objectswriteUpdate up to 100 CRM records of one object type in a single call.
batch_archive_objectswriteArchive (soft-delete) up to 100 CRM records of one object type in a single call.
list_associationsreadList the records associated with one CRM record (e.g. which contacts are linked to a deal).
associate_objectswriteLink two CRM records together (e.g. attach a contact to a deal, or a line item to a deal). Use association_type='' for HubSpot's default label, or a specific typed association id if you have one.
remove_associationwriteRemove the link between two CRM records without deleting either record.
list_propertiesreadList the properties (fields) defined on one CRM object type, including custom properties.
get_propertyreadRead one property's full definition (type, options if it's an enumeration, group).
create_propertywriteCreate a new custom property (field) on a CRM object type.
list_pipelinesreadList the pipelines defined for an object type (e.g. deal pipelines, ticket pipelines), each with its stages.
get_pipelinereadRead one pipeline in full, including its ordered stages.
list_ownersreadList HubSpot owners (the users records can be assigned to) -- id, name, email.
get_ownerreadRead one HubSpot owner in full by their owner id.
list_engagementsreadList logged activities of one type (note, call, email, meeting, task) across the whole portal.
get_engagementreadRead one logged activity (note/call/email/meeting/task) in full.
create_engagementwriteLog a new activity (note, call, email, meeting, or task) and optionally associate it with a CRM record right away, e.g. log a call on a contact.
update_engagementwriteUpdate the properties of an existing logged activity.
list_marketing_listsreadList static/active contact lists defined in the portal.
get_marketing_listreadRead one contact list's definition (name, size, static or dynamic).
list_list_membershipreadList the contact ids belonging to one static list.
add_contacts_to_listwriteAdd contacts to a static list by their record ids.
remove_contacts_from_listwriteRemove contacts from a static list by their record ids.
list_formsreadList marketing forms defined in the portal.
get_form_submissionsreadList submissions received on one form, most recent first.
list_filesreadList files stored in the portal's File Manager.
upload_filewriteUpload a file into the File Manager by fetching it from a publicly reachable URL.
get_filereadRead one file's metadata (URL, size, type) from the File Manager.
list_custom_object_schemasreadList custom object type definitions configured in this portal (Enterprise feature).
get_custom_object_schemareadRead one custom object type's full schema -- its properties and association rules.
create_custom_object_schemawriteDefine a brand-new custom object type in this portal (Enterprise feature). Once created, use the generic object tools with this type's fully-qualified name.
list_webhook_subscriptionsreadList event subscriptions configured for a HubSpot Developer App. Needs app_id; pass developer_api_key if it differs from the connected Private App token.
create_webhook_subscriptionwriteSubscribe a HubSpot Developer App to a CRM event (e.g. contact.creation, deal.propertyChange). Advanced flow -- requires a Developer App id, not just the portal's Private App token.
delete_webhook_subscriptionwriteRemove a webhook event subscription from a Developer App.
set_webhook_target_urlwriteSet (or change) the HTTPS endpoint a Developer App's webhook events are delivered to.
get_account_inforeadRead this portal's account details -- hub id, time zone, currency, account type.
get_pipeline_healthreadAudit one or all pipelines for an object type (deals or tickets): open record counts per stage, and how many are stale (not modified in stale_after_days).
find_duplicate_contactsreadScan the most recent contacts for likely duplicates grouped by email (or another property you choose).
bulk_update_deal_stagewriteMove up to 100 deals to a new pipeline stage in one call.
sync_checkreadQuick health check for this connection: verifies the token, and reports the portal id and granted scopes.
Install HubSpot and let Webbee use it across your workflow.
Open in panel