HUhubspot
Batch

Create or update a batch of emails by unique property values

Changed on

Create or update records 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/emails/batch/upsert

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/crm/objects/2026-03/emails/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-030e24e10a5e31Revision changes
    • info

      the endpoint scheme security oauth2 was removed from the API

    • info

      the endpoint scheme security oauth2 was removed from the API

  • 2026-03766403532217Revision changes
    • info

      the security scope crm.objects.contacts.write was added to the endpoint's security scheme oauth2

    • info

      the security scope sales-email-read was removed from the endpoint's security scheme oauth2