HUhubspot
Emails

Get revisions of a marketing email

Changed on

Get a list of all versions of a marketing email, with each entry including the full state of that particular version. To view the most recent version, sort by the updatedAt parameter.

get/marketing/emails/2026-09/{emailId}/revisions

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/marketing/emails/2026-09/{emailId}/revisions
  • 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

Path parameters

emailIdstring required

The unique identifier of the email for which to retrieve revisions.

Query parameters

afterstring

The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results.

beforestring

A cursor token for pagination to retrieve results before a specific point.

limitinteger

The maximum number of results to display per page.

Response

successful operation

totalinteger required

An integer representing the total number of email version results available.

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