HUhubspot
Batch

Batch upsert

Changed on

Create or update postal mails identified by a unique property value as specified by the idProperty query param. idProperty query param refers to a property whose values are unique for the object.

post/crm/objects/2026-03/postal_mail/batch/upsert

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/crm/objects/2026-03/postal_mail/batch/upsert
  • Auth
    none required

Request body

Response

successful operation

completedAtstring date-time required

The timestamp when the batch process was completed, in ISO 8601 format.

linksobject

A map of link names to associated URIs, providing additional information or actions related to the batch operation.

requestedAtstring date-time

The timestamp when the batch process was initiated, in ISO 8601 format.

startedAtstring date-time required

The timestamp when the batch process began execution, in ISO 8601 format.

status'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING' required

The status of the batch processing request. Can be: "PENDING", "PROCESSING", "CANCELED", or "COMPLETE".

Changes

  • 2026-03cc578f3a55a3Revision changes
    • info

      the endpoint scheme security oauth2 was removed from the API

  • 2026-03b8d9446f9691Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status