HUhubspot
Basic

Retrieve a campaign

Retrieve details of a specific marketing campaign identified by its internal ID. This endpoint allows you to access campaign information and associated assets. It is useful for obtaining campaign data for analysis or reporting purposes. If the properties to be returned are not defined with the 'properties' query parameter, the response will include an empty properties map.

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

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/marketing/campaigns/2026-09/{campaignGuid}
  • 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 to retrieve.

Query parameters

endDatestring

The end date for filtering campaign data, formatted as YYYY-MM-DD.

propertiesstring[]

A comma-separated list of property names to include in the response.

startDatestring

The start date for filtering campaign data, formatted as YYYY-MM-DD.

Response

successful operation

assetsobject required

A map of asset types to their respective collections of campaign assets, represented by CollectionResponsePublicCampaignAsset objects.

createdAtstring date-time required

The date and time when the campaign was created, in ISO 8601 format.

idstring required

The unique identifier for the campaign, represented as a string.

propertiesobject required

A map of custom property names to their values, where each value is a string.

updatedAtstring date-time required

The date and time when the campaign was last updated, in ISO 8601 format.

Changes

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