HUhubspot
Basic

Get aggregated statistics

Changed on

Use this endpoint to get aggregated statistics of emails sent in a specified time span. It also returns the list of emails that were sent during the time span.

get/marketing/emails/2026-09/statistics/list

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/marketing/emails/2026-09/statistics/list
  • Auth
    • OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: marketing.email.read
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: marketing.email.write
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: content

Query parameters

emailIdsinteger[]

A list of email IDs to filter the statistics. This should be a comma-separated list of integer IDs.

endTimestampstring date-time

The end of the time range for the statistics, in ISO 8601 date-time format.

propertystring

The specific property of the email statistics to retrieve.

startTimestampstring date-time

The start of the time range for the statistics, in ISO 8601 date-time format.

Response

successful operation

campaignAggregationsobject required

The aggregated statistics per campaign.

emailsinteger[] required

List of email IDs that were sent during the time span.

Changes

  • 2026-0963a409723776Revision changes
    • info

      the security scope marketing.email.read was added to the endpoint's security scheme oauth2

    • info

      the security scope content was removed from the endpoint's security scheme oauth2

  • 2026-09f3d5b6124704Revision changes
    • info

      the security scope marketing.email.read was added to the endpoint's security scheme oauth2

    • info

      the security scope content was removed from the endpoint's security scheme oauth2