Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt

Use this file to discover all available pages before exploring further.

Server path: /hubspot | Type: Application | PCID required: Yes

Tools

ToolDescription
hubspot_list_contactsList contacts from HubSpot CRM with pagination support
hubspot_get_contactRetrieve detailed information about a specific HubSpot contact
hubspot_create_contactCreate a new contact in HubSpot CRM
hubspot_update_contactUpdate an existing contact in HubSpot CRM
hubspot_delete_contactPermanently delete a contact from HubSpot CRM
hubspot_search_contactsSearch for contacts in HubSpot CRM using text queries
hubspot_get_user_detailsGet authenticated user details and account information from HubSpot
hubspot_list_objectsList objects of a specific type from HubSpot
hubspot_search_objectsSearch objects of a specific type in HubSpot
hubspot_batch_create_objectsCreate multiple objects in HubSpot in a single batch operation
hubspot_batch_update_objectsUpdate multiple objects in HubSpot in a single batch operation
hubspot_batch_read_objectsRead multiple objects from HubSpot in a single batch operation
hubspot_get_schemasGet all object schemas from HubSpot
hubspot_list_propertiesList all properties for a specific object type in HubSpot
hubspot_get_propertyGet a specific property definition from HubSpot
hubspot_create_propertyCreate a new custom property in HubSpot
hubspot_update_propertyUpdate an existing property in HubSpot
hubspot_create_associationCreate an association between two objects in HubSpot
hubspot_list_associationsList associations for a specific object in HubSpot
hubspot_get_association_definitionsGet association type definitions between two object types in Hubspot
hubspot_create_engagementCreate an engagement (note, task, call, email, meeting) in HubSpot
hubspot_get_engagementGet a specific engagement from HubSpot
hubspot_update_engagementUpdate an existing engagement in HubSpot
hubspot_list_workflowsList workflows from HubSpot
hubspot_get_workflowGet a specific workflow from HubSpot
hubspot_generate_feedback_linkGenerate a feedback link for HubSpot MCP tools
hubspot_get_linkGenerate HubSpot UI URL for a specific object
hubspot_create_dealCreate a deal in HubSpot with pipeline and stage
hubspot_get_dealGet a specific deal by ID from HubSpot
hubspot_update_dealUpdate an existing deal in HubSpot
hubspot_create_companyCreate a company in HubSpot
hubspot_get_companyGet a specific company by ID from HubSpot
hubspot_update_companyUpdate an existing company in HubSpot
hubspot_create_noteCreate a note and optionally associate it with contacts, companies, or deals
hubspot_list_dealsList deals in HubSpot with filtering and pagination
hubspot_list_companiesList companies in HubSpot with filtering and pagination
hubspot_get_deal_activitiesGet recent activities (engagements) associated with a deal. Returns calls, emails, meetings, notes, and tasks linked to the specified deal.
hubspot_list_productsList products from HubSpot product library
hubspot_get_productGet a specific product by ID from HubSpot
hubspot_list_line_itemsList line items from HubSpot. Line items are instances of products associated with deals, quotes, or invoices.
hubspot_get_line_itemGet a specific line item by ID from HubSpot
hubspot_list_ordersList orders from HubSpot. Orders represent e-commerce purchases.
hubspot_get_orderGet a specific order by ID from HubSpot
hubspot_list_invoicesList invoices from HubSpot Commerce Hub. Note: Invoices are read-only via the API.
hubspot_get_invoiceGet a specific invoice by ID from HubSpot. Note: Invoices are read-only via the API.
hubspot_create_postCreate a new blog post in HubSpot CMS. The post can be saved as a draft or published immediately.
hubspot_update_postUpdate an existing blog post in HubSpot CMS. Only provided fields will be updated.
hubspot_get_publish_channelsGet the list of connected social media publishing channels (LinkedIn, X/Twitter, etc.) for the current HubSpot account. Use this to discover available channel GUIDs before creating a broadcast.
hubspot_list_broadcastsList social media broadcasts (posts) from HubSpot. Returns scheduled, published, and draft broadcasts across connected LinkedIn and X/Twitter channels.
hubspot_get_broadcastGet details of a specific social media broadcast by its GUID.
hubspot_create_broadcastCreate a new social media broadcast (post) in HubSpot for publishing to LinkedIn or X (Twitter). Use hubspot_get_publish_channels first to get the channelGuid for the desired social account.
hubspot_delete_broadcastDelete a social media broadcast from HubSpot. Only drafts and scheduled broadcasts can be deleted; already published broadcasts cannot be removed.

hubspot_list_contacts

List contacts from HubSpot CRM with pagination support Parameters:
ParameterTypeRequiredDefaultDescription
limitnumberNo10Maximum number of contacts to return (default: 10, max: 100)

hubspot_get_contact

Retrieve detailed information about a specific HubSpot contact Parameters:
ParameterTypeRequiredDefaultDescription
contactIdstringYesThe unique HubSpot identifier of the contact to retrieve

hubspot_create_contact

Create a new contact in HubSpot CRM Parameters:
ParameterTypeRequiredDefaultDescription
propertiesobjectYesContact properties as key-value pairs (e.g., {“email”: “john@example.com”, “firstname”: “John”})

hubspot_update_contact

Update an existing contact in HubSpot CRM Parameters:
ParameterTypeRequiredDefaultDescription
contactIdstringYesThe unique HubSpot identifier of the contact to update
propertiesobjectYesContact properties to be updated as key-value pairs

hubspot_delete_contact

Permanently delete a contact from HubSpot CRM Parameters:
ParameterTypeRequiredDefaultDescription
contactIdstringYesThe unique HubSpot identifier of the contact to delete

hubspot_search_contacts

Search for contacts in HubSpot CRM using text queries Parameters:
ParameterTypeRequiredDefaultDescription
querystringYesSearch query to find contacts (searches across email, name, company, phone, and other contact properties)
limitnumberNo10Maximum number of contacts to return (default: 10, max: 100)

hubspot_get_user_details

Get authenticated user details and account information from HubSpot

hubspot_list_objects

List objects of a specific type from HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
objectTypestringYesThe type of object to list (e.g., contacts, companies, deals, tickets)
limitnumberNoMaximum number of objects to return
afterstringNoPagination cursor to get next set of results

hubspot_search_objects

Search objects of a specific type in HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
objectTypestringYesThe type of object to search (e.g., contacts, companies, deals, tickets)
querystringNoSearch query string to find objects
filtersobject[]NoArray of filter conditions to apply to the search
limitnumberNoMaximum number of objects to return

hubspot_batch_create_objects

Create multiple objects in HubSpot in a single batch operation Parameters:
ParameterTypeRequiredDefaultDescription
objectTypestringYesThe type of objects to create (e.g., contacts, companies, deals, tickets)
objectsobject[]YesArray of objects to create, each with their properties

hubspot_batch_update_objects

Update multiple objects in HubSpot in a single batch operation Parameters:
ParameterTypeRequiredDefaultDescription
objectTypestringYesThe type of objects to update (e.g., contacts, companies, deals, tickets)
objectsobject[]YesArray of objects to update, each with their ID and updated properties

hubspot_batch_read_objects

Read multiple objects from HubSpot in a single batch operation Parameters:
ParameterTypeRequiredDefaultDescription
objectTypestringYesThe type of objects to read (e.g., contacts, companies, deals, tickets)
idsstring[]YesArray of object IDs to retrieve
propertiesstring[]NoSpecific properties to retrieve for each object

hubspot_get_schemas

Get all object schemas from HubSpot

hubspot_list_properties

List all properties for a specific object type in HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
objectTypestringYesThe object type to list properties for (e.g., contacts, companies)

hubspot_get_property

Get a specific property definition from HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
objectTypestringYesThe object type the property belongs to (e.g., contacts, companies, deals etc.)
propertyNamestringYesThe name of the property to retrieve

hubspot_create_property

Create a new custom property in HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
objectTypestringYesThe object type to create the property for (e.g., contacts, companies, deals etc.)
propertyobjectYesProperty definition object

hubspot_update_property

Update an existing property in HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
objectTypestringYesThe object type the property belongs to (e.g., contacts, companies, deals, tickets)
propertyNamestringYesThe name of the property to update
propertyobjectYesProperty update object with fields to modify

hubspot_create_association

Create an association between two objects in HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
fromObjectTypestringYesThe object type of the source object (e.g., contacts, companies, deals)
fromObjectIdstringYesThe ID of the source object
toObjectTypestringYesThe object type of the target object (e.g., contacts, companies, deals)
toObjectIdstringYesThe ID of the target object
associationTypestringYesThe type of association to create (e.g., primary, unlabeled)

hubspot_list_associations

List associations for a specific object in HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
objectTypestringYesThe object type of the source object (e.g., contacts, companies, deals)
objectIdstringYesThe ID of the source object to list associations for
toObjectTypestringYesThe object type to find associations to (e.g., contacts, companies, deals)

hubspot_get_association_definitions

Get association type definitions between two object types in Hubspot Parameters:
ParameterTypeRequiredDefaultDescription
fromObjectTypestringYesThe source object type (e.g., contacts, companies, deals)
toObjectTypestringYesThe target object type (e.g., contacts, companies, deals)

hubspot_create_engagement

Create an engagement (note, task, call, email, meeting) in HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
engagementTypestringYesType of engagement to create. Accepts both singular and plural forms: note/notes, task/tasks, call/calls, email/emails, meeting/meetings
propertiesobjectYesKey-value pairs of engagement properties (e.g., subject, body, timestamp)
associationsobject[]NoOptional array of objects to associate the engagement with

hubspot_get_engagement

Get a specific engagement from HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
engagementTypestringYesType of engagement. Accepts both singular and plural forms: note/notes, task/tasks, call/calls, email/emails, meeting/meetings
engagementIdstringYesThe unique identifier of the engagement to retrieve

hubspot_update_engagement

Update an existing engagement in HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
engagementTypestringYesType of engagement. Accepts both singular and plural forms: note/notes, task/tasks, call/calls, email/emails, meeting/meetings
engagementIdstringYesThe unique identifier of the engagement to update
propertiesobjectYesKey-value pairs of engagement properties to update

hubspot_list_workflows

List workflows from HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
limitnumberNoMaximum number of workflows to return

hubspot_get_workflow

Get a specific workflow from HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
workflowIdstringYesThe unique identifier of the workflow to retrieve

Generate a feedback link for HubSpot MCP tools
Generate HubSpot UI URL for a specific object Parameters:
ParameterTypeRequiredDefaultDescription
objectTypestringYesThe type of object to generate a link for (e.g., contacts, companies, deals, tickets)
objectIdstringYesThe unique identifier of the object to generate a link for

hubspot_create_deal

Create a deal in HubSpot with pipeline and stage Parameters:
ParameterTypeRequiredDefaultDescription
dealnamestringYesName of the deal
amountstringNoDeal amount
pipelinestringNoDeal pipeline ID
dealstagestringNoDeal stage ID
closedatestringNoExpected close date (YYYY-MM-DD)
dealtypestringNoType of deal (newbusiness, existingbusiness, etc.)
descriptionstringNoDeal description
hubspot_owner_idstringNoHubSpot owner ID for the deal

hubspot_get_deal

Get a specific deal by ID from HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
dealIdstringYesID of the deal to retrieve
propertiesstring[]NoSpecific properties to retrieve

hubspot_update_deal

Update an existing deal in HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
dealIdstringYesID of the deal to update
dealnamestringNoName of the deal
amountstringNoDeal amount
dealstagestringNoDeal stage ID
closedatestringNoExpected close date (YYYY-MM-DD)
descriptionstringNoDeal description

hubspot_create_company

Create a company in HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesCompany name
domainstringNoCompany domain/website
industrystringNoCompany industry
citystringNoCompany city
statestringNoCompany state
countrystringNoCompany country
phonestringNoCompany phone number
numberofemployeesstringNoNumber of employees
annualrevenuestringNoAnnual revenue
descriptionstringNoCompany description

hubspot_get_company

Get a specific company by ID from HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringYesID of the company to retrieve
propertiesstring[]NoSpecific properties to retrieve

hubspot_update_company

Update an existing company in HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
companyIdstringYesID of the company to update
namestringNoCompany name
domainstringNoCompany domain/website
industrystringNoCompany industry
citystringNoCompany city
phonestringNoCompany phone number
descriptionstringNoCompany description

hubspot_create_note

Create a note and optionally associate it with contacts, companies, or deals Parameters:
ParameterTypeRequiredDefaultDescription
bodystringYesContent of the note
timestampstringNoTimestamp for the note (ISO format)
associatedObjectTypestringNoType of object to associate with (contacts, companies, deals)
associatedObjectIdstringNoID of the object to associate the note with

hubspot_list_deals

List deals in HubSpot with filtering and pagination Parameters:
ParameterTypeRequiredDefaultDescription
limitnumberNo10Number of deals to retrieve
propertiesstring[]NoSpecific properties to retrieve
pipelinestringNoFilter by pipeline ID
dealstagestringNoFilter by deal stage ID

hubspot_list_companies

List companies in HubSpot with filtering and pagination Parameters:
ParameterTypeRequiredDefaultDescription
limitnumberNo10Number of companies to retrieve
propertiesstring[]NoSpecific properties to retrieve
citystringNoFilter by city
industrystringNoFilter by industry

hubspot_get_deal_activities

Get recent activities (engagements) associated with a deal. Returns calls, emails, meetings, notes, and tasks linked to the specified deal. Parameters:
ParameterTypeRequiredDefaultDescription
dealIdstringYesID of the deal to get activities for
activityTypesstring[]NoTypes of activities to retrieve. If not specified, all types are retrieved.
limitnumberNo50Maximum number of activities per type to retrieve

hubspot_list_products

List products from HubSpot product library Parameters:
ParameterTypeRequiredDefaultDescription
limitnumberNo10Number of products to retrieve
propertiesstring[]NoSpecific properties to retrieve

hubspot_get_product

Get a specific product by ID from HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
productIdstringYesID of the product to retrieve
propertiesstring[]NoSpecific properties to retrieve

hubspot_list_line_items

List line items from HubSpot. Line items are instances of products associated with deals, quotes, or invoices. Parameters:
ParameterTypeRequiredDefaultDescription
limitnumberNo10Number of line items to retrieve
propertiesstring[]NoSpecific properties to retrieve

hubspot_get_line_item

Get a specific line item by ID from HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
lineItemIdstringYesID of the line item to retrieve
propertiesstring[]NoSpecific properties to retrieve

hubspot_list_orders

List orders from HubSpot. Orders represent e-commerce purchases. Parameters:
ParameterTypeRequiredDefaultDescription
limitnumberNo10Number of orders to retrieve
propertiesstring[]NoSpecific properties to retrieve

hubspot_get_order

Get a specific order by ID from HubSpot Parameters:
ParameterTypeRequiredDefaultDescription
orderIdstringYesID of the order to retrieve
propertiesstring[]NoSpecific properties to retrieve

hubspot_list_invoices

List invoices from HubSpot Commerce Hub. Note: Invoices are read-only via the API. Parameters:
ParameterTypeRequiredDefaultDescription
limitnumberNo10Number of invoices to retrieve
propertiesstring[]NoSpecific properties to retrieve

hubspot_get_invoice

Get a specific invoice by ID from HubSpot. Note: Invoices are read-only via the API. Parameters:
ParameterTypeRequiredDefaultDescription
invoiceIdstringYesID of the invoice to retrieve
propertiesstring[]NoSpecific properties to retrieve

hubspot_create_post

Create a new blog post in HubSpot CMS. The post can be saved as a draft or published immediately. Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesThe title of the blog post
contentGroupIdstringYesThe ID of the blog (content group) this post belongs to. Use hubspot_list_objects with objectType “blogs” or the HubSpot CMS API to find available blog IDs.
postBodystringYesThe HTML body content of the blog post
slugstringNoURL slug for the post (auto-generated from title if not provided)
metaDescriptionstringNoMeta description for SEO
postSummarystringNoSummary/excerpt of the blog post (HTML)
blogAuthorIdstringNoThe ID of the blog author
featuredImagestringNoURL of the featured image
statestringNo"DRAFT"Publish state of the post (default: DRAFT)
htmlTitlestringNoHTML title tag for the post (defaults to name if not provided)

hubspot_update_post

Update an existing blog post in HubSpot CMS. Only provided fields will be updated. Parameters:
ParameterTypeRequiredDefaultDescription
postIdstringYesThe ID of the blog post to update
namestringNoUpdated title of the blog post
postBodystringNoUpdated HTML body content of the blog post
slugstringNoUpdated URL slug
metaDescriptionstringNoUpdated meta description for SEO
postSummarystringNoUpdated summary/excerpt of the blog post (HTML)
blogAuthorIdstringNoUpdated blog author ID
featuredImagestringNoUpdated URL of the featured image
statestringNoUpdated publish state
htmlTitlestringNoUpdated HTML title tag

hubspot_get_publish_channels

Get the list of connected social media publishing channels (LinkedIn, X/Twitter, etc.) for the current HubSpot account. Use this to discover available channel GUIDs before creating a broadcast.

hubspot_list_broadcasts

List social media broadcasts (posts) from HubSpot. Returns scheduled, published, and draft broadcasts across connected LinkedIn and X/Twitter channels. Parameters:
ParameterTypeRequiredDefaultDescription
countnumberNo20Number of broadcasts to return (default: 20)
offsetnumberNoOffset for pagination

hubspot_get_broadcast

Get details of a specific social media broadcast by its GUID. Parameters:
ParameterTypeRequiredDefaultDescription
broadcastGuidstringYesThe GUID of the broadcast to retrieve

hubspot_create_broadcast

Create a new social media broadcast (post) in HubSpot for publishing to LinkedIn or X (Twitter). Use hubspot_get_publish_channels first to get the channelGuid for the desired social account. Parameters:
ParameterTypeRequiredDefaultDescription
channelGuidstringYesThe GUID of the social channel to publish to (get from hubspot_get_publish_channels)
contentobjectYesThe broadcast content object
triggerAtnumberNoUnix timestamp in milliseconds for when to publish the post. If omitted, the post may need to be published manually or will be saved as a draft.

hubspot_delete_broadcast

Delete a social media broadcast from HubSpot. Only drafts and scheduled broadcasts can be deleted; already published broadcasts cannot be removed. Parameters:
ParameterTypeRequiredDefaultDescription
broadcastGuidstringYesThe GUID of the broadcast to delete