HUhubspot
Reports

Retrieve metrics

Fetch the metrics of a specific marketing campaign using its unique identifier. This endpoint allows you to gather insights into campaign performance over a specified date range.

get/marketing/campaigns/2026-09/{campaignGuid}/reports/metrics

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/marketing/campaigns/2026-09/{campaignGuid}/reports/metrics
  • Auth
    OAuth 2
    Authorization code: https://app.hubspot.com/oauth/authorize
    Token URL: https://api.hubapi.com/oauth/v1/token scopes: marketing.campaigns.read

Path parameters

campaignGuidstring required

The unique identifier of the campaign.

Query parameters

endDatestring

The end date for fetching campaign metrics, formatted as YYYY-MM-DD.

startDatestring

The start date for fetching campaign metrics, formatted as YYYY-MM-DD.

Response

successful operation

influencedContactsinteger required

The number of contacts that were influenced by the campaign. This is an integer value.

newContactsFirstTouchinteger required

The number of new contacts that had their first interaction with the campaign. This is an integer value.

newContactsLastTouchinteger required

The number of new contacts that had their last interaction with the campaign. This is an integer value.

sessionsinteger required

The number of sessions associated with the campaign. This is an integer value.

Changes

No recorded changes to this operation across all 5 revisions of this API.