HubSpot CRM icon

HubSpot CRM

Interact with HubSpot CRM API

Batch Upsert

AI-generated

Summary

Upsert HubSpot CRM objects in batches using every incoming item: match each record by the configured ID field and HubSpot ID property, then create or update it with the mapped properties. The operation sends requests in batches of up to 100 and returns one item per HubSpot result.

Inputs

  • Object Type (required) — Choose the CRM object type, such as contacts, companies, or deals. For Custom, provide the custom object type name or ID.
  • ID Property — HubSpot property used to identify a record; defaults to hs_object_id. Select a unique property, such as email for contacts, when matching by that property.
  • ID Field (required) — Input field containing the identifier value. Supports dot notation, such as properties.id. Every item must have a non-empty value in this field.
  • Property Mappings (required) — Add at least one mapping from an input field to a HubSpot property. Input field names support dot notation. Values that are missing or null on an item are omitted from that item's properties.

Output shape

A list of items, one per HubSpot upsert result, each containing the result in json.

All incoming items are processed, with requests grouped in batches of up to 100. Each output is paired with the corresponding input item. The node errors if no mappings are configured, an input field cannot be found, or an item is missing its ID value.

Links

Discussion