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-03/statistics/list

Request

  • Base URL
    https://api.hubapi.com
  • Auth
    • OAuth 2
      Authorization codehttps://app.hubspot.com/oauth/authorize
      Token URLhttps://api.hubapi.com/oauth/v1/token
      Scopesmarketing.email.read
    • or OAuth 2
      Authorization codehttps://app.hubspot.com/oauth/authorize
      Token URLhttps://api.hubapi.com/oauth/v1/token
      Scopesmarketing.email.write
    • or OAuth 2
      Authorization codehttps://app.hubspot.com/oauth/authorize
      Token URLhttps://api.hubapi.com/oauth/v1/token
      Scopesmarketplace_validation
    • or OAuth 2
      Authorization codehttps://app.hubspot.com/oauth/authorize
      Token URLhttps://api.hubapi.com/oauth/v1/token
      Scopescontent

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-03a2b5d0cf80abRevision 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-03deba4fb9e606Revision changes
    • info

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

    1 more change in this revision