Batch read objects
The HubSpot Batch Read Objects tool allows users to efficiently retrieve multiple HubSpot CRM objects of the same type by their IDs in a single batch request. This streamlines data access and management for sales, marketing, and customer service teams.
Features
- Supports retrieval of various HubSpot object types including contacts, companies, deals, tickets, and more.
- Enables batch reading of up to 100 object IDs per request for improved efficiency.
- Allows specifying which object properties to include in the response for customized data retrieval.
- Supports fetching property histories to track changes over time.
- Integrates seamlessly within HubSpot workflows and API environments for easy automation.
Benefits
- Speeds up data querying by retrieving multiple objects in one API call, reducing latency and server load.
- Enhances CRM data management by providing flexible access to only the necessary object fields.
- Improves workflow automation by integrating batch reads into existing HubSpot processes.
- Facilitates comprehensive data analysis with access to property history.
- Saves developer time by simplifying complex multi-object data retrieval tasks.
Description
🎯 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.
Parameters
4 parameters
| Name | Type | Description |
|---|---|---|
| objectTyperequired | string | 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. |
| inputsrequired | object[] | Array of object IDs to read (maximum 100 per batch) |
| properties | string[] | Optional list of property names to include in the results |
| propertiesWithHistory | string[] | Optional list of property names to include with history |