HUhubspot
Basic

Update

Changed on

Perform a partial update of an Object identified by {emailId}or optionally a unique property value as specified by the idProperty query param. {emailId} refers to the internal object ID by default, and the idProperty query param refers to a property whose values are unique for the object. Provided property values will be overwritten. Read-only and non-existent properties will result in an error. Properties values can be cleared by passing an empty string.

patch/crm/objects/2026-03/emails/{emailId}

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/crm/objects/2026-03/emails/{emailId}
  • Auth
    none required

Path parameters

emailIdstring required

Query parameters

idPropertystring

The name of a property whose values are unique for this object type

Request body

propertiesobject required

Key value pairs representing the properties of the object.

Response

successful operation

archivedboolean required

Whether the object is archived.

archivedAtstring date-time

The timestamp when the object was archived, in ISO 8601 format.

createdAtstring date-time required

The timestamp when the object was created, in ISO 8601 format.

idstring required

The unique ID of the object.

objectWriteTraceIdstring

An identifier used to trace the write request for the object. Set a unique ID for each write operation; it is returned with any errors so you can identify which request encountered which error.

propertiesobject required

Key-value pairs representing the properties of the object.

propertiesWithHistoryobject

Key-value pairs representing the properties of the object along with their history, each with a timestamp and source information.

updatedAtstring date-time required

The timestamp when the object was last updated, in ISO 8601 format.

urlstring

The URL associated with the object.

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