> ## 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.
# hubspot
> Contacts, deals, companies, and pipelines
**Server path:** `/hubspot` | **Type:** Application | **PCID required:** Yes
## Tools
| Tool | Description |
| ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`hubspot_list_contacts`](#hubspot_list_contacts) | List contacts from HubSpot CRM with pagination support |
| [`hubspot_get_contact`](#hubspot_get_contact) | Retrieve detailed information about a specific HubSpot contact |
| [`hubspot_create_contact`](#hubspot_create_contact) | Create a new contact in HubSpot CRM |
| [`hubspot_update_contact`](#hubspot_update_contact) | Update an existing contact in HubSpot CRM |
| [`hubspot_delete_contact`](#hubspot_delete_contact) | Permanently delete a contact from HubSpot CRM |
| [`hubspot_search_contacts`](#hubspot_search_contacts) | Search for contacts in HubSpot CRM using text queries |
| [`hubspot_get_user_details`](#hubspot_get_user_details) | Get authenticated user details and account information from HubSpot |
| [`hubspot_list_objects`](#hubspot_list_objects) | List objects of a specific type from HubSpot |
| [`hubspot_search_objects`](#hubspot_search_objects) | Search objects of a specific type in HubSpot |
| [`hubspot_batch_create_objects`](#hubspot_batch_create_objects) | Create multiple objects in HubSpot in a single batch operation |
| [`hubspot_batch_update_objects`](#hubspot_batch_update_objects) | Update multiple objects in HubSpot in a single batch operation |
| [`hubspot_batch_read_objects`](#hubspot_batch_read_objects) | Read multiple objects from HubSpot in a single batch operation |
| [`hubspot_get_schemas`](#hubspot_get_schemas) | Get all object schemas from HubSpot |
| [`hubspot_list_properties`](#hubspot_list_properties) | List all properties for a specific object type in HubSpot |
| [`hubspot_get_property`](#hubspot_get_property) | Get a specific property definition from HubSpot |
| [`hubspot_create_property`](#hubspot_create_property) | Create a new custom property in HubSpot |
| [`hubspot_update_property`](#hubspot_update_property) | Update an existing property in HubSpot |
| [`hubspot_create_association`](#hubspot_create_association) | Create an association between two objects in HubSpot |
| [`hubspot_list_associations`](#hubspot_list_associations) | List associations for a specific object in HubSpot |
| [`hubspot_get_association_definitions`](#hubspot_get_association_definitions) | Get association type definitions between two object types in Hubspot |
| [`hubspot_create_engagement`](#hubspot_create_engagement) | Create an engagement (note, task, call, email, meeting) in HubSpot |
| [`hubspot_get_engagement`](#hubspot_get_engagement) | Get a specific engagement from HubSpot |
| [`hubspot_update_engagement`](#hubspot_update_engagement) | Update an existing engagement in HubSpot |
| [`hubspot_list_workflows`](#hubspot_list_workflows) | List workflows from HubSpot |
| [`hubspot_get_workflow`](#hubspot_get_workflow) | Get a specific workflow from HubSpot |
| [`hubspot_generate_feedback_link`](#hubspot_generate_feedback_link) | Generate a feedback link for HubSpot MCP tools |
| [`hubspot_get_link`](#hubspot_get_link) | Generate HubSpot UI URL for a specific object |
| [`hubspot_create_deal`](#hubspot_create_deal) | Create a deal in HubSpot with pipeline and stage |
| [`hubspot_get_deal`](#hubspot_get_deal) | Get a specific deal by ID from HubSpot |
| [`hubspot_update_deal`](#hubspot_update_deal) | Update an existing deal in HubSpot |
| [`hubspot_create_company`](#hubspot_create_company) | Create a company in HubSpot |
| [`hubspot_get_company`](#hubspot_get_company) | Get a specific company by ID from HubSpot |
| [`hubspot_update_company`](#hubspot_update_company) | Update an existing company in HubSpot |
| [`hubspot_create_note`](#hubspot_create_note) | Create a note and optionally associate it with contacts, companies, or deals |
| [`hubspot_list_deals`](#hubspot_list_deals) | List deals in HubSpot with filtering and pagination |
| [`hubspot_list_companies`](#hubspot_list_companies) | List companies in HubSpot with filtering and pagination |
| [`hubspot_get_deal_activities`](#hubspot_get_deal_activities) | Get recent activities (engagements) associated with a deal. Returns calls, emails, meetings, notes, and tasks linked to the specified deal. |
| [`hubspot_list_products`](#hubspot_list_products) | List products from HubSpot product library |
| [`hubspot_get_product`](#hubspot_get_product) | Get a specific product by ID from HubSpot |
| [`hubspot_list_line_items`](#hubspot_list_line_items) | List line items from HubSpot. Line items are instances of products associated with deals, quotes, or invoices. |
| [`hubspot_get_line_item`](#hubspot_get_line_item) | Get a specific line item by ID from HubSpot |
| [`hubspot_list_orders`](#hubspot_list_orders) | List orders from HubSpot. Orders represent e-commerce purchases. |
| [`hubspot_get_order`](#hubspot_get_order) | Get a specific order by ID from HubSpot |
| [`hubspot_list_invoices`](#hubspot_list_invoices) | List invoices from HubSpot Commerce Hub. Note: Invoices are read-only via the API. |
| [`hubspot_get_invoice`](#hubspot_get_invoice) | Get a specific invoice by ID from HubSpot. Note: Invoices are read-only via the API. |
| [`hubspot_create_post`](#hubspot_create_post) | Create a new blog post in HubSpot CMS. The post can be saved as a draft or published immediately. |
| [`hubspot_update_post`](#hubspot_update_post) | Update an existing blog post in HubSpot CMS. Only provided fields will be updated. |
| [`hubspot_get_publish_channels`](#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`](#hubspot_list_broadcasts) | List social media broadcasts (posts) from HubSpot. Returns scheduled, published, and draft broadcasts across connected LinkedIn and X/Twitter channels. |
| [`hubspot_get_broadcast`](#hubspot_get_broadcast) | Get details of a specific social media broadcast by its GUID. |
| [`hubspot_create_broadcast`](#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. HubSpot's v1 Broadcast API has no true draft state, and any missing/past/near-now triggerAt causes HubSpot to publish immediately — so by default this tool schedules the post 90 days out (landing in HubSpot's Scheduled queue for human review). Pass publishImmediately=true to publish now (only when the user has explicitly asked for that), or pass a specific future triggerAt to schedule for a specific time. To attach an image to the post, put its public URL in content.photoUrl (use hubspot\_upload\_file first if you need a stable HubSpot-hosted URL). |
| [`hubspot_delete_broadcast`](#hubspot_delete_broadcast) | Delete a social media broadcast from HubSpot. Only drafts and scheduled broadcasts can be deleted; already published broadcasts cannot be removed. |
| [`hubspot_upload_file`](#hubspot_upload_file) | Upload a file to HubSpot's File Manager by fetching it from a public source URL. Returns the HubSpot-hosted public URL, which can be passed as `content.photoUrl` to hubspot\_create\_broadcast to attach an image to a LinkedIn or X post. Use this when you have a temporary/signed URL or want a stable HubSpot-hosted copy. |
***
## hubspot\_list\_contacts
List contacts from HubSpot CRM with pagination support
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------- | ------ | -------- | ------- | ------------------------------------------------------------ |
| `limit` | number | No | `10` | Maximum number of contacts to return (default: 10, max: 100) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"limit": {
"type": "number",
"default": 10,
"description": "Maximum number of contacts to return (default: 10, max: 100)"
}
},
"required": [
"PCID"
]
}
```
***
## hubspot\_get\_contact
Retrieve detailed information about a specific HubSpot contact
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------- | ------ | -------- | ------- | -------------------------------------------------------- |
| `contactId` | string | Yes | — | The unique HubSpot identifier of the contact to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"contactId": {
"type": "string",
"description": "The unique HubSpot identifier of the contact to retrieve"
}
},
"required": [
"PCID",
"contactId"
]
}
```
***
## hubspot\_create\_contact
Create a new contact in HubSpot CRM
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `properties` | object | Yes | — | Contact properties as key-value pairs (e.g., \{"email": "[john@example.com](mailto:john@example.com)", "firstname": "John"}) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"properties": {
"type": "object",
"additionalProperties": true,
"description": "Contact properties as key-value pairs (e.g., {\"email\": \"john@example.com\", \"firstname\": \"John\"})"
}
},
"required": [
"PCID",
"properties"
]
}
```
***
## hubspot\_update\_contact
Update an existing contact in HubSpot CRM
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | ------ | -------- | ------- | ------------------------------------------------------ |
| `contactId` | string | Yes | — | The unique HubSpot identifier of the contact to update |
| `properties` | object | Yes | — | Contact properties to be updated as key-value pairs |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"contactId": {
"type": "string",
"description": "The unique HubSpot identifier of the contact to update"
},
"properties": {
"type": "object",
"additionalProperties": true,
"description": "Contact properties to be updated as key-value pairs"
}
},
"required": [
"PCID",
"contactId",
"properties"
]
}
```
***
## hubspot\_delete\_contact
Permanently delete a contact from HubSpot CRM
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------- | ------ | -------- | ------- | ------------------------------------------------------ |
| `contactId` | string | Yes | — | The unique HubSpot identifier of the contact to delete |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"contactId": {
"type": "string",
"description": "The unique HubSpot identifier of the contact to delete"
}
},
"required": [
"PCID",
"contactId"
]
}
```
***
## hubspot\_search\_contacts
Search for contacts in HubSpot CRM using text queries
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------- | ------ | -------- | ------- | --------------------------------------------------------------------------------------------------------- |
| `query` | string | Yes | — | Search query to find contacts (searches across email, name, company, phone, and other contact properties) |
| `limit` | number | No | `10` | Maximum number of contacts to return (default: 10, max: 100) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"query": {
"type": "string",
"description": "Search query to find contacts (searches across email, name, company, phone, and other contact properties)"
},
"limit": {
"type": "number",
"default": 10,
"description": "Maximum number of contacts to return (default: 10, max: 100)"
}
},
"required": [
"PCID",
"query"
]
}
```
***
## hubspot\_get\_user\_details
Get authenticated user details and account information from HubSpot
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
}
},
"required": [
"PCID"
]
}
```
***
## hubspot\_list\_objects
List objects of a specific type from HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | ------ | -------- | ------- | ---------------------------------------------------------------------- |
| `objectType` | string | Yes | — | The type of object to list (e.g., contacts, companies, deals, tickets) |
| `limit` | number | No | — | Maximum number of objects to return |
| `after` | string | No | — | Pagination cursor to get next set of results |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"objectType": {
"type": "string",
"description": "The type of object to list (e.g., contacts, companies, deals, tickets)"
},
"limit": {
"type": "number",
"description": "Maximum number of objects to return"
},
"after": {
"type": "string",
"description": "Pagination cursor to get next set of results"
}
},
"required": [
"PCID",
"objectType"
]
}
```
***
## hubspot\_search\_objects
Search objects of a specific type in HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | --------- | -------- | ------- | ------------------------------------------------------------------------ |
| `objectType` | string | Yes | — | The type of object to search (e.g., contacts, companies, deals, tickets) |
| `query` | string | No | — | Search query string to find objects |
| `filters` | object\[] | No | — | Array of filter conditions to apply to the search |
| `limit` | number | No | — | Maximum number of objects to return |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"objectType": {
"type": "string",
"description": "The type of object to search (e.g., contacts, companies, deals, tickets)"
},
"query": {
"type": "string",
"description": "Search query string to find objects"
},
"filters": {
"type": "array",
"items": {
"type": "object",
"properties": {
"propertyName": {
"type": "string",
"description": "Name of the property to filter on"
},
"operator": {
"type": "string",
"description": "Filter operator (e.g., EQ, NEQ, LT, GT, CONTAINS)"
},
"value": {
"type": "string",
"description": "Value to filter by"
}
}
},
"description": "Array of filter conditions to apply to the search"
},
"limit": {
"type": "number",
"description": "Maximum number of objects to return"
}
},
"required": [
"PCID",
"objectType"
]
}
```
***
## hubspot\_batch\_create\_objects
Create multiple objects in HubSpot in a single batch operation
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | --------- | -------- | ------- | ------------------------------------------------------------------------- |
| `objectType` | string | Yes | — | The type of objects to create (e.g., contacts, companies, deals, tickets) |
| `objects` | object\[] | Yes | — | Array of objects to create, each with their properties |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"objectType": {
"type": "string",
"description": "The type of objects to create (e.g., contacts, companies, deals, tickets)"
},
"objects": {
"type": "array",
"items": {
"type": "object",
"properties": {
"properties": {
"type": "object",
"additionalProperties": true,
"description": "Key-value pairs of object properties"
}
}
},
"description": "Array of objects to create, each with their properties"
}
},
"required": [
"PCID",
"objectType",
"objects"
]
}
```
***
## hubspot\_batch\_update\_objects
Update multiple objects in HubSpot in a single batch operation
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | --------- | -------- | ------- | ------------------------------------------------------------------------- |
| `objectType` | string | Yes | — | The type of objects to update (e.g., contacts, companies, deals, tickets) |
| `objects` | object\[] | Yes | — | Array of objects to update, each with their ID and updated properties |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"objectType": {
"type": "string",
"description": "The type of objects to update (e.g., contacts, companies, deals, tickets)"
},
"objects": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The unique identifier of the object to update"
},
"properties": {
"type": "object",
"additionalProperties": true,
"description": "Key-value pairs of object properties to update"
}
}
},
"description": "Array of objects to update, each with their ID and updated properties"
}
},
"required": [
"PCID",
"objectType",
"objects"
]
}
```
***
## hubspot\_batch\_read\_objects
Read multiple objects from HubSpot in a single batch operation
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | --------- | -------- | ------- | ----------------------------------------------------------------------- |
| `objectType` | string | Yes | — | The type of objects to read (e.g., contacts, companies, deals, tickets) |
| `ids` | string\[] | Yes | — | Array of object IDs to retrieve |
| `properties` | string\[] | No | — | Specific properties to retrieve for each object |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"objectType": {
"type": "string",
"description": "The type of objects to read (e.g., contacts, companies, deals, tickets)"
},
"ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of object IDs to retrieve"
},
"properties": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific properties to retrieve for each object"
}
},
"required": [
"PCID",
"objectType",
"ids"
]
}
```
***
## hubspot\_get\_schemas
Get all object schemas from HubSpot
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
}
},
"required": [
"PCID"
]
}
```
***
## hubspot\_list\_properties
List all properties for a specific object type in HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | ------ | -------- | ------- | ------------------------------------------------------------------ |
| `objectType` | string | Yes | — | The object type to list properties for (e.g., contacts, companies) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"objectType": {
"type": "string",
"description": "The object type to list properties for (e.g., contacts, companies)"
}
},
"required": [
"PCID",
"objectType"
]
}
```
***
## hubspot\_get\_property
Get a specific property definition from HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| -------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------- |
| `objectType` | string | Yes | — | The object type the property belongs to (e.g., contacts, companies, deals etc.) |
| `propertyName` | string | Yes | — | The name of the property to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"objectType": {
"type": "string",
"description": "The object type the property belongs to (e.g., contacts, companies, deals etc.)"
},
"propertyName": {
"type": "string",
"description": "The name of the property to retrieve"
}
},
"required": [
"PCID",
"objectType",
"propertyName"
]
}
```
***
## hubspot\_create\_property
Create a new custom property in HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | ------ | -------- | ------- | ---------------------------------------------------------------------------------- |
| `objectType` | string | Yes | — | The object type to create the property for (e.g., contacts, companies, deals etc.) |
| `property` | object | Yes | — | Property definition object |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"objectType": {
"type": "string",
"description": "The object type to create the property for (e.g., contacts, companies, deals etc.)"
},
"property": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Internal name of the property (used in API calls)"
},
"label": {
"type": "string",
"description": "Display label for the property in HubSpot UI"
},
"type": {
"type": "string",
"description": "Data type of the property (e.g., string, number, bool, datetime, enumeration, etc.)"
},
"fieldType": {
"type": "string",
"description": "UI field type (e.g., text, textarea, select, radio, checkbox)"
},
"groupName": {
"type": "string",
"description": "Property group to organize the property under"
},
"description": {
"type": "string",
"description": "Optional description of the property"
}
},
"description": "Property definition object"
}
},
"required": [
"PCID",
"objectType",
"property"
]
}
```
***
## hubspot\_update\_property
Update an existing property in HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| -------------- | ------ | -------- | ------- | ----------------------------------------------------------------------------------- |
| `objectType` | string | Yes | — | The object type the property belongs to (e.g., contacts, companies, deals, tickets) |
| `propertyName` | string | Yes | — | The name of the property to update |
| `property` | object | Yes | — | Property update object with fields to modify |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"objectType": {
"type": "string",
"description": "The object type the property belongs to (e.g., contacts, companies, deals, tickets)"
},
"propertyName": {
"type": "string",
"description": "The name of the property to update"
},
"property": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "Updated display label for the property"
},
"description": {
"type": "string",
"description": "Updated description of the property"
}
},
"description": "Property update object with fields to modify"
}
},
"required": [
"PCID",
"objectType",
"propertyName",
"property"
]
}
```
***
## hubspot\_create\_association
Create an association between two objects in HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------------- | ------ | -------- | ------- | ----------------------------------------------------------------------- |
| `fromObjectType` | string | Yes | — | The object type of the source object (e.g., contacts, companies, deals) |
| `fromObjectId` | string | Yes | — | The ID of the source object |
| `toObjectType` | string | Yes | — | The object type of the target object (e.g., contacts, companies, deals) |
| `toObjectId` | string | Yes | — | The ID of the target object |
| `associationType` | string | Yes | — | The type of association to create (e.g., primary, unlabeled) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"fromObjectType": {
"type": "string",
"description": "The object type of the source object (e.g., contacts, companies, deals)"
},
"fromObjectId": {
"type": "string",
"description": "The ID of the source object"
},
"toObjectType": {
"type": "string",
"description": "The object type of the target object (e.g., contacts, companies, deals)"
},
"toObjectId": {
"type": "string",
"description": "The ID of the target object"
},
"associationType": {
"type": "string",
"description": "The type of association to create (e.g., primary, unlabeled)"
}
},
"required": [
"PCID",
"fromObjectType",
"fromObjectId",
"toObjectType",
"toObjectId",
"associationType"
]
}
```
***
## hubspot\_list\_associations
List associations for a specific object in HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| -------------- | ------ | -------- | ------- | -------------------------------------------------------------------------- |
| `objectType` | string | Yes | — | The object type of the source object (e.g., contacts, companies, deals) |
| `objectId` | string | Yes | — | The ID of the source object to list associations for |
| `toObjectType` | string | Yes | — | The object type to find associations to (e.g., contacts, companies, deals) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"objectType": {
"type": "string",
"description": "The object type of the source object (e.g., contacts, companies, deals)"
},
"objectId": {
"type": "string",
"description": "The ID of the source object to list associations for"
},
"toObjectType": {
"type": "string",
"description": "The object type to find associations to (e.g., contacts, companies, deals)"
}
},
"required": [
"PCID",
"objectType",
"objectId",
"toObjectType"
]
}
```
***
## hubspot\_get\_association\_definitions
Get association type definitions between two object types in Hubspot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------------- | ------ | -------- | ------- | --------------------------------------------------------- |
| `fromObjectType` | string | Yes | — | The source object type (e.g., contacts, companies, deals) |
| `toObjectType` | string | Yes | — | The target object type (e.g., contacts, companies, deals) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"fromObjectType": {
"type": "string",
"description": "The source object type (e.g., contacts, companies, deals)"
},
"toObjectType": {
"type": "string",
"description": "The target object type (e.g., contacts, companies, deals)"
}
},
"required": [
"PCID",
"fromObjectType",
"toObjectType"
]
}
```
***
## hubspot\_create\_engagement
Create an engagement (note, task, call, email, meeting) in HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------------- | --------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `engagementType` | string | Yes | — | Type of engagement to create. Accepts both singular and plural forms: note/notes, task/tasks, call/calls, email/emails, meeting/meetings |
| `properties` | object | Yes | — | Key-value pairs of engagement properties (e.g., subject, body, timestamp) |
| `associations` | object\[] | No | — | Optional array of objects to associate the engagement with |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"engagementType": {
"type": "string",
"description": "Type of engagement to create. Accepts both singular and plural forms: note/notes, task/tasks, call/calls, email/emails, meeting/meetings"
},
"properties": {
"type": "object",
"additionalProperties": true,
"description": "Key-value pairs of engagement properties (e.g., subject, body, timestamp)"
},
"associations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"to": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "ID of the object to associate with"
}
},
"description": "Target object for association"
},
"types": {
"type": "array",
"items": {
"type": "object",
"properties": {
"associationCategory": {
"type": "string",
"description": "Category of association (e.g., HUBSPOT_DEFINED, USER_DEFINED)"
},
"associationTypeId": {
"type": "number",
"description": "Numeric ID of the association type"
}
}
},
"description": "Array of association type definitions"
}
}
},
"description": "Optional array of objects to associate the engagement with"
}
},
"required": [
"PCID",
"engagementType",
"properties"
]
}
```
***
## hubspot\_get\_engagement
Get a specific engagement from HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `engagementType` | string | Yes | — | Type of engagement. Accepts both singular and plural forms: note/notes, task/tasks, call/calls, email/emails, meeting/meetings |
| `engagementId` | string | Yes | — | The unique identifier of the engagement to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"engagementType": {
"type": "string",
"description": "Type of engagement. Accepts both singular and plural forms: note/notes, task/tasks, call/calls, email/emails, meeting/meetings"
},
"engagementId": {
"type": "string",
"description": "The unique identifier of the engagement to retrieve"
}
},
"required": [
"PCID",
"engagementType",
"engagementId"
]
}
```
***
## hubspot\_update\_engagement
Update an existing engagement in HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `engagementType` | string | Yes | — | Type of engagement. Accepts both singular and plural forms: note/notes, task/tasks, call/calls, email/emails, meeting/meetings |
| `engagementId` | string | Yes | — | The unique identifier of the engagement to update |
| `properties` | object | Yes | — | Key-value pairs of engagement properties to update |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"engagementType": {
"type": "string",
"description": "Type of engagement. Accepts both singular and plural forms: note/notes, task/tasks, call/calls, email/emails, meeting/meetings"
},
"engagementId": {
"type": "string",
"description": "The unique identifier of the engagement to update"
},
"properties": {
"type": "object",
"additionalProperties": true,
"description": "Key-value pairs of engagement properties to update"
}
},
"required": [
"PCID",
"engagementType",
"engagementId",
"properties"
]
}
```
***
## hubspot\_list\_workflows
List workflows from HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------- | ------ | -------- | ------- | ------------------------------------- |
| `limit` | number | No | — | Maximum number of workflows to return |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"limit": {
"type": "number",
"description": "Maximum number of workflows to return"
}
},
"required": [
"PCID"
]
}
```
***
## hubspot\_get\_workflow
Get a specific workflow from HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | ------ | -------- | ------- | ------------------------------------------------- |
| `workflowId` | string | Yes | — | The unique identifier of the workflow to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"workflowId": {
"type": "string",
"description": "The unique identifier of the workflow to retrieve"
}
},
"required": [
"PCID",
"workflowId"
]
}
```
***
## hubspot\_generate\_feedback\_link
Generate a feedback link for HubSpot MCP tools
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
}
},
"required": [
"PCID"
]
}
```
***
## hubspot\_get\_link
Generate HubSpot UI URL for a specific object
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | ------ | -------- | ------- | ------------------------------------------------------------------------------------- |
| `objectType` | string | Yes | — | The type of object to generate a link for (e.g., contacts, companies, deals, tickets) |
| `objectId` | string | Yes | — | The unique identifier of the object to generate a link for |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"objectType": {
"type": "string",
"description": "The type of object to generate a link for (e.g., contacts, companies, deals, tickets)"
},
"objectId": {
"type": "string",
"description": "The unique identifier of the object to generate a link for"
}
},
"required": [
"PCID",
"objectType",
"objectId"
]
}
```
***
## hubspot\_create\_deal
Create a deal in HubSpot with pipeline and stage
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------------ | ------ | -------- | ------- | -------------------------------------------------- |
| `dealname` | string | Yes | — | Name of the deal |
| `amount` | string | No | — | Deal amount |
| `pipeline` | string | No | — | Deal pipeline ID |
| `dealstage` | string | No | — | Deal stage ID |
| `closedate` | string | No | — | Expected close date (YYYY-MM-DD) |
| `dealtype` | string | No | — | Type of deal (newbusiness, existingbusiness, etc.) |
| `description` | string | No | — | Deal description |
| `hubspot_owner_id` | string | No | — | HubSpot owner ID for the deal |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"dealname": {
"type": "string",
"description": "Name of the deal"
},
"amount": {
"type": "string",
"description": "Deal amount"
},
"pipeline": {
"type": "string",
"description": "Deal pipeline ID"
},
"dealstage": {
"type": "string",
"description": "Deal stage ID"
},
"closedate": {
"type": "string",
"description": "Expected close date (YYYY-MM-DD)"
},
"dealtype": {
"type": "string",
"description": "Type of deal (newbusiness, existingbusiness, etc.)"
},
"description": {
"type": "string",
"description": "Deal description"
},
"hubspot_owner_id": {
"type": "string",
"description": "HubSpot owner ID for the deal"
}
},
"required": [
"PCID",
"dealname"
]
}
```
***
## hubspot\_get\_deal
Get a specific deal by ID from HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | --------- | -------- | ------- | ------------------------------- |
| `dealId` | string | Yes | — | ID of the deal to retrieve |
| `properties` | string\[] | No | — | Specific properties to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"dealId": {
"type": "string",
"description": "ID of the deal to retrieve"
},
"properties": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific properties to retrieve"
}
},
"required": [
"PCID",
"dealId"
]
}
```
***
## hubspot\_update\_deal
Update an existing deal in HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------- | ------ | -------- | ------- | -------------------------------- |
| `dealId` | string | Yes | — | ID of the deal to update |
| `dealname` | string | No | — | Name of the deal |
| `amount` | string | No | — | Deal amount |
| `dealstage` | string | No | — | Deal stage ID |
| `closedate` | string | No | — | Expected close date (YYYY-MM-DD) |
| `description` | string | No | — | Deal description |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"dealId": {
"type": "string",
"description": "ID of the deal to update"
},
"dealname": {
"type": "string",
"description": "Name of the deal"
},
"amount": {
"type": "string",
"description": "Deal amount"
},
"dealstage": {
"type": "string",
"description": "Deal stage ID"
},
"closedate": {
"type": "string",
"description": "Expected close date (YYYY-MM-DD)"
},
"description": {
"type": "string",
"description": "Deal description"
}
},
"required": [
"PCID",
"dealId"
]
}
```
***
## hubspot\_create\_company
Create a company in HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------------- | ------ | -------- | ------- | ---------------------- |
| `name` | string | Yes | — | Company name |
| `domain` | string | No | — | Company domain/website |
| `industry` | string | No | — | Company industry |
| `city` | string | No | — | Company city |
| `state` | string | No | — | Company state |
| `country` | string | No | — | Company country |
| `phone` | string | No | — | Company phone number |
| `numberofemployees` | string | No | — | Number of employees |
| `annualrevenue` | string | No | — | Annual revenue |
| `description` | string | No | — | Company description |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"name": {
"type": "string",
"description": "Company name"
},
"domain": {
"type": "string",
"description": "Company domain/website"
},
"industry": {
"type": "string",
"description": "Company industry"
},
"city": {
"type": "string",
"description": "Company city"
},
"state": {
"type": "string",
"description": "Company state"
},
"country": {
"type": "string",
"description": "Company country"
},
"phone": {
"type": "string",
"description": "Company phone number"
},
"numberofemployees": {
"type": "string",
"description": "Number of employees"
},
"annualrevenue": {
"type": "string",
"description": "Annual revenue"
},
"description": {
"type": "string",
"description": "Company description"
}
},
"required": [
"PCID",
"name"
]
}
```
***
## hubspot\_get\_company
Get a specific company by ID from HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | --------- | -------- | ------- | ------------------------------- |
| `companyId` | string | Yes | — | ID of the company to retrieve |
| `properties` | string\[] | No | — | Specific properties to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"companyId": {
"type": "string",
"description": "ID of the company to retrieve"
},
"properties": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific properties to retrieve"
}
},
"required": [
"PCID",
"companyId"
]
}
```
***
## hubspot\_update\_company
Update an existing company in HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------- | ------ | -------- | ------- | --------------------------- |
| `companyId` | string | Yes | — | ID of the company to update |
| `name` | string | No | — | Company name |
| `domain` | string | No | — | Company domain/website |
| `industry` | string | No | — | Company industry |
| `city` | string | No | — | Company city |
| `phone` | string | No | — | Company phone number |
| `description` | string | No | — | Company description |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"companyId": {
"type": "string",
"description": "ID of the company to update"
},
"name": {
"type": "string",
"description": "Company name"
},
"domain": {
"type": "string",
"description": "Company domain/website"
},
"industry": {
"type": "string",
"description": "Company industry"
},
"city": {
"type": "string",
"description": "Company city"
},
"phone": {
"type": "string",
"description": "Company phone number"
},
"description": {
"type": "string",
"description": "Company description"
}
},
"required": [
"PCID",
"companyId"
]
}
```
***
## hubspot\_create\_note
Create a note and optionally associate it with contacts, companies, or deals
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ---------------------- | ------ | -------- | ------- | ------------------------------------------------------------- |
| `body` | string | Yes | — | Content of the note |
| `timestamp` | string | No | — | Timestamp for the note (ISO format) |
| `associatedObjectType` | string | No | — | Type of object to associate with (contacts, companies, deals) |
| `associatedObjectId` | string | No | — | ID of the object to associate the note with |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"body": {
"type": "string",
"description": "Content of the note"
},
"timestamp": {
"type": "string",
"description": "Timestamp for the note (ISO format)"
},
"associatedObjectType": {
"type": "string",
"description": "Type of object to associate with (contacts, companies, deals)"
},
"associatedObjectId": {
"type": "string",
"description": "ID of the object to associate the note with"
}
},
"required": [
"PCID",
"body"
]
}
```
***
## hubspot\_list\_deals
List deals in HubSpot with filtering and pagination
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | --------- | -------- | ------- | ------------------------------- |
| `limit` | number | No | `10` | Number of deals to retrieve |
| `properties` | string\[] | No | — | Specific properties to retrieve |
| `pipeline` | string | No | — | Filter by pipeline ID |
| `dealstage` | string | No | — | Filter by deal stage ID |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"limit": {
"type": "number",
"default": 10,
"description": "Number of deals to retrieve"
},
"properties": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific properties to retrieve"
},
"pipeline": {
"type": "string",
"description": "Filter by pipeline ID"
},
"dealstage": {
"type": "string",
"description": "Filter by deal stage ID"
}
},
"required": [
"PCID"
]
}
```
***
## hubspot\_list\_companies
List companies in HubSpot with filtering and pagination
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | --------- | -------- | ------- | ------------------------------- |
| `limit` | number | No | `10` | Number of companies to retrieve |
| `properties` | string\[] | No | — | Specific properties to retrieve |
| `city` | string | No | — | Filter by city |
| `industry` | string | No | — | Filter by industry |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"limit": {
"type": "number",
"default": 10,
"description": "Number of companies to retrieve"
},
"properties": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific properties to retrieve"
},
"city": {
"type": "string",
"description": "Filter by city"
},
"industry": {
"type": "string",
"description": "Filter by industry"
}
},
"required": [
"PCID"
]
}
```
***
## 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:**
| Parameter | Type | Required | Default | Description |
| --------------- | --------- | -------- | ------- | --------------------------------------------------------------------------- |
| `dealId` | string | Yes | — | ID of the deal to get activities for |
| `activityTypes` | string\[] | No | — | Types of activities to retrieve. If not specified, all types are retrieved. |
| `limit` | number | No | `50` | Maximum number of activities per type to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"dealId": {
"type": "string",
"description": "ID of the deal to get activities for"
},
"activityTypes": {
"type": "array",
"items": {
"type": "string",
"enum": [
"calls",
"emails",
"meetings",
"notes",
"tasks"
]
},
"description": "Types of activities to retrieve. If not specified, all types are retrieved."
},
"limit": {
"type": "number",
"default": 50,
"description": "Maximum number of activities per type to retrieve"
}
},
"required": [
"PCID",
"dealId"
]
}
```
***
## hubspot\_list\_products
List products from HubSpot product library
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | --------- | -------- | ------- | ------------------------------- |
| `limit` | number | No | `10` | Number of products to retrieve |
| `properties` | string\[] | No | — | Specific properties to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"limit": {
"type": "number",
"default": 10,
"description": "Number of products to retrieve"
},
"properties": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific properties to retrieve"
}
},
"required": [
"PCID"
]
}
```
***
## hubspot\_get\_product
Get a specific product by ID from HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | --------- | -------- | ------- | ------------------------------- |
| `productId` | string | Yes | — | ID of the product to retrieve |
| `properties` | string\[] | No | — | Specific properties to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"productId": {
"type": "string",
"description": "ID of the product to retrieve"
},
"properties": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific properties to retrieve"
}
},
"required": [
"PCID",
"productId"
]
}
```
***
## hubspot\_list\_line\_items
List line items from HubSpot. Line items are instances of products associated with deals, quotes, or invoices.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | --------- | -------- | ------- | -------------------------------- |
| `limit` | number | No | `10` | Number of line items to retrieve |
| `properties` | string\[] | No | — | Specific properties to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"limit": {
"type": "number",
"default": 10,
"description": "Number of line items to retrieve"
},
"properties": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific properties to retrieve"
}
},
"required": [
"PCID"
]
}
```
***
## hubspot\_get\_line\_item
Get a specific line item by ID from HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | --------- | -------- | ------- | ------------------------------- |
| `lineItemId` | string | Yes | — | ID of the line item to retrieve |
| `properties` | string\[] | No | — | Specific properties to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"lineItemId": {
"type": "string",
"description": "ID of the line item to retrieve"
},
"properties": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific properties to retrieve"
}
},
"required": [
"PCID",
"lineItemId"
]
}
```
***
## hubspot\_list\_orders
List orders from HubSpot. Orders represent e-commerce purchases.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | --------- | -------- | ------- | ------------------------------- |
| `limit` | number | No | `10` | Number of orders to retrieve |
| `properties` | string\[] | No | — | Specific properties to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"limit": {
"type": "number",
"default": 10,
"description": "Number of orders to retrieve"
},
"properties": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific properties to retrieve"
}
},
"required": [
"PCID"
]
}
```
***
## hubspot\_get\_order
Get a specific order by ID from HubSpot
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | --------- | -------- | ------- | ------------------------------- |
| `orderId` | string | Yes | — | ID of the order to retrieve |
| `properties` | string\[] | No | — | Specific properties to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"orderId": {
"type": "string",
"description": "ID of the order to retrieve"
},
"properties": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific properties to retrieve"
}
},
"required": [
"PCID",
"orderId"
]
}
```
***
## hubspot\_list\_invoices
List invoices from HubSpot Commerce Hub. Note: Invoices are read-only via the API.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | --------- | -------- | ------- | ------------------------------- |
| `limit` | number | No | `10` | Number of invoices to retrieve |
| `properties` | string\[] | No | — | Specific properties to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"limit": {
"type": "number",
"default": 10,
"description": "Number of invoices to retrieve"
},
"properties": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific properties to retrieve"
}
},
"required": [
"PCID"
]
}
```
***
## hubspot\_get\_invoice
Get a specific invoice by ID from HubSpot. Note: Invoices are read-only via the API.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | --------- | -------- | ------- | ------------------------------- |
| `invoiceId` | string | Yes | — | ID of the invoice to retrieve |
| `properties` | string\[] | No | — | Specific properties to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID"
},
"invoiceId": {
"type": "string",
"description": "ID of the invoice to retrieve"
},
"properties": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific properties to retrieve"
}
},
"required": [
"PCID",
"invoiceId"
]
}
```
***
## hubspot\_create\_post
Create a new blog post in HubSpot CMS. The post can be saved as a draft or published immediately.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------------- | ------ | -------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name` | string | Yes | — | The title of the blog post |
| `contentGroupId` | string | Yes | — | The 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. |
| `postBody` | string | Yes | — | The HTML body content of the blog post |
| `slug` | string | No | — | URL slug for the post (auto-generated from title if not provided) |
| `metaDescription` | string | No | — | Meta description for SEO |
| `postSummary` | string | No | — | Summary/excerpt of the blog post (HTML) |
| `blogAuthorId` | string | No | — | The ID of the blog author |
| `featuredImage` | string | No | — | URL of the featured image |
| `state` | string | No | `"DRAFT"` | Publish state of the post (default: DRAFT) |
| `htmlTitle` | string | No | — | HTML title tag for the post (defaults to name if not provided) |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"name": {
"type": "string",
"description": "The title of the blog post"
},
"contentGroupId": {
"type": "string",
"description": "The 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."
},
"postBody": {
"type": "string",
"description": "The HTML body content of the blog post"
},
"slug": {
"type": "string",
"description": "URL slug for the post (auto-generated from title if not provided)"
},
"metaDescription": {
"type": "string",
"description": "Meta description for SEO"
},
"postSummary": {
"type": "string",
"description": "Summary/excerpt of the blog post (HTML)"
},
"blogAuthorId": {
"type": "string",
"description": "The ID of the blog author"
},
"featuredImage": {
"type": "string",
"description": "URL of the featured image"
},
"state": {
"type": "string",
"enum": [
"DRAFT",
"PUBLISHED"
],
"default": "DRAFT",
"description": "Publish state of the post (default: DRAFT)"
},
"htmlTitle": {
"type": "string",
"description": "HTML title tag for the post (defaults to name if not provided)"
}
},
"required": [
"PCID",
"name",
"contentGroupId",
"postBody"
]
}
```
***
## hubspot\_update\_post
Update an existing blog post in HubSpot CMS. Only provided fields will be updated.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ----------------- | ------ | -------- | ------- | ----------------------------------------------- |
| `postId` | string | Yes | — | The ID of the blog post to update |
| `name` | string | No | — | Updated title of the blog post |
| `postBody` | string | No | — | Updated HTML body content of the blog post |
| `slug` | string | No | — | Updated URL slug |
| `metaDescription` | string | No | — | Updated meta description for SEO |
| `postSummary` | string | No | — | Updated summary/excerpt of the blog post (HTML) |
| `blogAuthorId` | string | No | — | Updated blog author ID |
| `featuredImage` | string | No | — | Updated URL of the featured image |
| `state` | string | No | — | Updated publish state |
| `htmlTitle` | string | No | — | Updated HTML title tag |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"postId": {
"type": "string",
"description": "The ID of the blog post to update"
},
"name": {
"type": "string",
"description": "Updated title of the blog post"
},
"postBody": {
"type": "string",
"description": "Updated HTML body content of the blog post"
},
"slug": {
"type": "string",
"description": "Updated URL slug"
},
"metaDescription": {
"type": "string",
"description": "Updated meta description for SEO"
},
"postSummary": {
"type": "string",
"description": "Updated summary/excerpt of the blog post (HTML)"
},
"blogAuthorId": {
"type": "string",
"description": "Updated blog author ID"
},
"featuredImage": {
"type": "string",
"description": "Updated URL of the featured image"
},
"state": {
"type": "string",
"enum": [
"DRAFT",
"PUBLISHED"
],
"description": "Updated publish state"
},
"htmlTitle": {
"type": "string",
"description": "Updated HTML title tag"
}
},
"required": [
"PCID",
"postId"
]
}
```
***
## 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.
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
}
},
"required": [
"PCID"
]
}
```
***
## hubspot\_list\_broadcasts
List social media broadcasts (posts) from HubSpot. Returns scheduled, published, and draft broadcasts across connected LinkedIn and X/Twitter channels.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------- | ------ | -------- | ------- | -------------------------------------------- |
| `count` | number | No | `20` | Number of broadcasts to return (default: 20) |
| `offset` | number | No | — | Offset for pagination |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"count": {
"type": "number",
"default": 20,
"description": "Number of broadcasts to return (default: 20)"
},
"offset": {
"type": "number",
"description": "Offset for pagination"
}
},
"required": [
"PCID"
]
}
```
***
## hubspot\_get\_broadcast
Get details of a specific social media broadcast by its GUID.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| --------------- | ------ | -------- | ------- | ------------------------------------- |
| `broadcastGuid` | string | Yes | — | The GUID of the broadcast to retrieve |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"broadcastGuid": {
"type": "string",
"description": "The GUID of the broadcast to retrieve"
}
},
"required": [
"PCID",
"broadcastGuid"
]
}
```
***
## 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. HubSpot's v1 Broadcast API has no true draft state, and any missing/past/near-now triggerAt causes HubSpot to publish immediately — so by default this tool schedules the post 90 days out (landing in HubSpot's Scheduled queue for human review). Pass publishImmediately=true to publish now (only when the user has explicitly asked for that), or pass a specific future triggerAt to schedule for a specific time. To attach an image to the post, put its public URL in content.photoUrl (use hubspot\_upload\_file first if you need a stable HubSpot-hosted URL).
**Parameters:**
| Parameter | Type | Required | Default | Description |
| -------------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `channelGuid` | string | Yes | — | The GUID of the social channel to publish to (get from hubspot\_get\_publish\_channels) |
| `content` | object | Yes | — | The broadcast content object |
| `triggerAt` | number | No | — | Unix timestamp in milliseconds for when to publish the post. Must be at least 5 minutes in the future; anything missing, in the past, or within 5 minutes of now is clamped to 90 days from now so the post is scheduled (not published immediately) and can be reviewed in HubSpot's Social tool. Ignored when publishImmediately is true. |
| `publishImmediately` | boolean | No | — | Set to true to publish the post immediately instead of scheduling it. Overrides triggerAt. Default: false (safe, scheduled for human review). Use only when the user has explicitly asked to publish now. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"channelGuid": {
"type": "string",
"description": "The GUID of the social channel to publish to (get from hubspot_get_publish_channels)"
},
"content": {
"type": "object",
"properties": {
"body": {
"type": "string",
"description": "The text content of the social media post"
},
"photoUrl": {
"type": "string",
"description": "Publicly accessible URL of an image to attach to the post (e.g., a HubSpot File Manager URL from hubspot_upload_file). LinkedIn and X will embed this image."
},
"link": {
"type": "string",
"description": "URL to attach as a link preview"
},
"linkTitle": {
"type": "string",
"description": "Title for the attached link preview"
},
"linkDescription": {
"type": "string",
"description": "Description for the attached link preview"
}
},
"description": "The broadcast content object"
},
"triggerAt": {
"type": "number",
"description": "Unix timestamp in milliseconds for when to publish the post. Must be at least 5 minutes in the future; anything missing, in the past, or within 5 minutes of now is clamped to 90 days from now so the post is scheduled (not published immediately) and can be reviewed in HubSpot's Social tool. Ignored when publishImmediately is true."
},
"publishImmediately": {
"type": "boolean",
"description": "Set to true to publish the post immediately instead of scheduling it. Overrides triggerAt. Default: false (safe, scheduled for human review). Use only when the user has explicitly asked to publish now."
}
},
"required": [
"PCID",
"channelGuid",
"content"
]
}
```
***
## 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:**
| Parameter | Type | Required | Default | Description |
| --------------- | ------ | -------- | ------- | ----------------------------------- |
| `broadcastGuid` | string | Yes | — | The GUID of the broadcast to delete |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"broadcastGuid": {
"type": "string",
"description": "The GUID of the broadcast to delete"
}
},
"required": [
"PCID",
"broadcastGuid"
]
}
```
***
## hubspot\_upload\_file
Upload a file to HubSpot's File Manager by fetching it from a public source URL. Returns the HubSpot-hosted public URL, which can be passed as `content.photoUrl` to hubspot\_create\_broadcast to attach an image to a LinkedIn or X post. Use this when you have a temporary/signed URL or want a stable HubSpot-hosted copy.
**Parameters:**
| Parameter | Type | Required | Default | Description |
| ------------ | ------ | -------- | ------- | -------------------------------------------------------------------------------- |
| `sourceUrl` | string | Yes | — | Publicly accessible URL of the file to fetch and upload |
| `fileName` | string | No | — | Optional filename to save as in HubSpot. If omitted, derived from the sourceUrl. |
| `folderPath` | string | No | — | Optional HubSpot File Manager folder path to place the file in |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "The PinkConnect ID for authentication"
},
"sourceUrl": {
"type": "string",
"description": "Publicly accessible URL of the file to fetch and upload"
},
"fileName": {
"type": "string",
"description": "Optional filename to save as in HubSpot. If omitted, derived from the sourceUrl."
},
"folderPath": {
"type": "string",
"description": "Optional HubSpot File Manager folder path to place the file in"
}
},
"required": [
"PCID",
"sourceUrl"
]
}
```