hubspot-get-link
Generate HubSpot UI links for specific object details or index pages using object types and IDs. Validate object type IDs and create accurate references to HubSpot records.
Instructions
🎯 Purpose:
1. Generates HubSpot UI links for different pages based on object types and IDs.
2. Supports both index pages (lists of objects) and record pages (specific object details).
📋 Prerequisites:
1. Use the hubspot-get-user-details tool to get the PortalId and UiDomain.
🧭 Usage Guidance:
1. Use to generate links to HubSpot UI pages when users need to reference specific HubSpot records.
2. Validates that object type IDs exist in the HubSpot system.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
pageRequests | Yes | Array of page link requests to generate | |
portalId | Yes | The HubSpot portal/account ID | |
uiDomain | Yes | The HubSpot UI domain(e.g., 'app.hubspot.com') |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"pageRequests": {
"description": "Array of page link requests to generate",
"items": {
"additionalProperties": false,
"properties": {
"objectId": {
"description": "The specific object ID to link to (required for 'record' page types)",
"type": "string"
},
"objectTypeId": {
"description": "The HubSpot object type ID to link to (e.g., '0-1', '0-2' for contacts, companies, or '2-x' for custom objects)",
"type": "string"
},
"pagetype": {
"description": "The type of page to link to: 'record' for a specific object's page, 'index' for a list page",
"enum": [
"record",
"index"
],
"type": "string"
}
},
"required": [
"pagetype",
"objectTypeId"
],
"type": "object"
},
"type": "array"
},
"portalId": {
"description": "The HubSpot portal/account ID",
"type": "string"
},
"uiDomain": {
"description": "The HubSpot UI domain(e.g., 'app.hubspot.com')",
"type": "string"
}
},
"required": [
"portalId",
"uiDomain",
"pageRequests"
],
"type": "object"
}