Pular para o conteúdo principal
GET
/
marketing
/
v3
/
campaigns
/
{campaignGuid}
/
reports
/
contacts
/
{contactType}
Buscar IDs de contato
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

Autorizações

​
Authorization
string
header
obrigatório

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

Parâmetros de caminho

​
campaignGuid
string
obrigatório

O identificador exclusivo da campanha

​
contactType
string
obrigatório

O tipo de contato para filtrar a lista

Parâmetros de consulta

​
after
string

O token do cursor de paginação do último recurso lido com sucesso será retornado como a propriedade JSON "paging.next.after" de uma resposta paginada que contém mais resultados.

​
endDate
string

A data de término para buscar dados de contato, no formato AAAA-MM-DD. Opcional. Exemplo: 2000-01-27

​
limit
integer<int32>

O número máximo de resultados a serem exibidos por página.

​
startDate
string

A data de início para buscar dados de contato, no formato AAAA-MM-DD. Opcional. Exemplo: 2000-01-20

Resposta

successful operation

​
results
object[]
obrigatório

Uma matriz de referências de contato. Cada uma delas contém um identificador para um contato.

​
paging
object
Last modified on May 11, 2026