hubspot-batch-read-objects
Retrieve multiple HubSpot objects by their IDs in a single batch operation using this tool. Specify the object type and up to 100 IDs to efficiently fetch data, with optional properties and history included.
Instructions
🎯 Purpose:
1. Retrieves multiple HubSpot objects of the same object type by their IDs in a single batch operation.
🧭 Usage Guidance:
1. Use this tool to retrieve objects when the object IDs are known.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| inputs | Yes | Array of object IDs to read (maximum 100 per batch) | |
| objectType | Yes | The type of HubSpot object to read. Valid values include: appointments, companies, contacts, courses, deals, leads, line_items, listings, marketing_events, meetings, orders, postal_mail, products, quotes, services, subscriptions, tickets, users. For custom objects, use the hubspot-get-schemas tool to get the objectType. | |
| properties | No | Optional list of property names to include in the results | |
| propertiesWithHistory | No | Optional list of property names to include with history |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"inputs": {
"description": "Array of object IDs to read (maximum 100 per batch)",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"description": "ID of the object to read",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
},
"objectType": {
"description": "The type of HubSpot object to read. Valid values include: appointments, companies, contacts, courses, deals, leads, line_items, listings, marketing_events, meetings, orders, postal_mail, products, quotes, services, subscriptions, tickets, users. For custom objects, use the hubspot-get-schemas tool to get the objectType.",
"type": "string"
},
"properties": {
"description": "Optional list of property names to include in the results",
"items": {
"type": "string"
},
"type": "array"
},
"propertiesWithHistory": {
"description": "Optional list of property names to include with history",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"objectType",
"inputs"
],
"type": "object"
}