Skip to main content
GET
/
marketing
/
v3
/
campaigns
/
{campaignGuid}
Read a campaign
curl --request GET \
  --url https://api.hubapi.com/marketing/v3/campaigns/{campaignGuid} \
  --header 'Authorization: Bearer <token>'
{
  "createdAt": "2023-11-07T05:31:56Z",
  "businessUnits": [
    {
      "id": 123
    }
  ],
  "assets": {},
  "id": "<string>",
  "properties": {},
  "updatedAt": "2023-11-07T05:31:56Z"
}

Supported products

Requires one of the following products or higher.
Marketing HubMarketing Hub -Professional
Sales HubSales Hub -Free
Service HubService Hub -Free
Content HubContent Hub -Free
This API requires one of the following scopes:
marketing.campaigns.read

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
campaignGuid
string
required

Unique identifier for the campaign, formatted as a UUID.

Query Parameters

​
startDate
string

Start date to fetch asset metrics, formatted as YYYY-MM-DD. This date is used to fetch the metrics associated with the assets for a specified period. If not provided, no asset metrics will be fetched.

​
endDate
string

End date to fetch asset metrics, formatted as YYYY-MM-DD. This date is used to fetch the metrics associated with the assets for a specified period. If not provided, no asset metrics will be fetched.

​
properties
string[]

A comma-separated list of the properties to be returned in the response. If any of the specified properties has empty value on the requested object, they will be ignored and not returned in response. If this parameter is empty, the response will include an empty properties map.

Response

successful operation

​
createdAt
string<date-time>
required
​
businessUnits
object[]
required
​
assets
object
required
​
id
string
required
​
properties
object
required
​
updatedAt
string<date-time>
required