post-crm-v4-objects-objtype-batch-read_read
Batch-read HubSpot CRM objects by internal ID or unique property values, returning specified properties and their histories in one request.
Instructions
Read a batch of objects by internal ID, or unique property values. REQUIRES body parameter with object IDs and properties to retrieve. Example: {body: {inputs: [{"id": "123"}, {"id": "456"}], properties: ["firstname", "lastname", "email"], propertiesWithHistory: []}}
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"objectType": "<objectType>",
"propertiesWithHistory": "<propertiesWithHistory>",
"inputs": "<inputs>",
"properties": "<properties>"
},
"name": "post-crm-v4-objects-objtype-batch-read_read"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| inputs | Yes | Array of items | |
| idProperty | No | When using a custom unique value property to retrieve records, the name of the property. Do not include this parameter if retrieving by record ID. | |
| objectType | Yes | Path parameter objectType | |
| properties | Yes | Key-value pairs for setting properties for the new object. | |
| propertiesWithHistory | Yes | Key-value pairs for setting properties for the new object and their histories. |