Batch

Batch update subscription status

Update the subscription status for a set of contacts.

post/communication-preferences/2026-09/statuses/batch/write

Request

Base URL
https://api.hubapi.com
URL
https://api.hubapi.com/communication-preferences/2026-09/statuses/batch/write
Auth
OAuth 2
Authorization code: https://app.hubspot.com/oauth/authorize
Token URL: https://api.hubapi.com/oauth/v1/token scopes: communication_preferences.statuses.batch.write

successful operation

completedAtstring date-time required

The date and time when the batch operation was completed.

linksobject

URLs linking to related resources or documentation.

numErrorsinteger

The number of errors encountered during the batch operation.

requestedAtstring date-time

The date and time when the request was made.

startedAtstring date-time required

The date and time when the batch operation started.

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

The current status of the batch operation, which can be PENDING, PROCESSING, CANCELED, or COMPLETE.