Skip to main content
GET
/
marketing
/
v3
/
campaigns
/
{campaignGuid}
/
reports
/
contacts
/
{contactType}
Fetch contact IDs
curl --request GET \
  --url https://api.hubapi.com/marketing/v3/campaigns/{campaignGuid}/reports/contacts/{contactType} \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "id": "<string>"
    }
  ],
  "paging": {
    "next": {
      "after": "<string>",
      "link": "<string>"
    }
  }
}

Supported products

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
campaignGuid
string
required

The unique identifier of the campaign

​
contactType
string
required

The type of contact to filter the list

Query Parameters

​
after
string

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.

​
endDate
string
​
limit
integer<int32>

The maximum number of results to display per page.

​
startDate
string

Response

successful operation

​
results
object[]
required
​
paging
object
Last modified on March 30, 2026