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-03/{emailId}/revisions

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

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-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