hubspot-batch-update-objects
Batch update multiple HubSpot CRM objects of the same type in a single API call. Use this tool to modify existing object properties efficiently, ensuring accurate and streamlined data updates.
Instructions
🛡️ Guardrails:
1. Data Modification Warning: This tool modifies HubSpot data. Only use when the user has explicitly requested to update their CRM.
🎯 Purpose:
1. Updates multiple existing HubSpot objects of the same objectType in a single API call.
2. Use this tool when the user wants to update one or more existing CRM objects.
3. If you are unsure about the property type to update, identify existing properties of the object and ask the user.
📋 Prerequisites:
1. Use the hubspot-get-user-details tool to get the OwnerId and UserId if you don't have that already.
2. Use the hubspot-list-objects tool to sample existing objects for the object type.
3. If hubspot-list-objects tool's response isn't helpful, use hubspot-list-properties tool.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| inputs | Yes | Array of objects to update (maximum 100 per batch) | |
| objectType | Yes | The type of HubSpot object to update. 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. |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"inputs": {
"description": "Array of objects to update (maximum 100 per batch)",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"description": "ID of the object to update",
"type": "string"
},
"idProperty": {
"description": "Optional unique property name to use as the ID",
"type": "string"
},
"objectWriteTraceId": {
"description": "Optional trace ID for debugging purposes",
"type": "string"
},
"properties": {
"additionalProperties": {
"type": "string"
},
"description": "Object properties as key-value pairs",
"type": "object"
}
},
"required": [
"id",
"properties"
],
"type": "object"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
},
"objectType": {
"description": "The type of HubSpot object to update. 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"
}
},
"required": [
"objectType",
"inputs"
],
"type": "object"
}