Pular para o conteúdo principal
GET
/
marketing
/
v3
/
campaigns
/
{campaignGuid}
Ler uma campanha
curl --request GET \
  --url https://api.hubapi.com/marketing/v3/campaigns/{campaignGuid} \
  --header 'Authorization: Bearer <token>'
{
  "assets": {},
  "businessUnits": [
    {
      "id": 123
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "properties": {},
  "updatedAt": "2023-11-07T05:31:56Z"
}

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 UUID da campanha; obrigatório Exemplo: 9dbec438-53e2-4b28-8c0f-38f56574a6e8

Parâmetros de consulta

endDate
string

A data final para buscar métricas de ativos, no formato AAAA-MM-DD. Opcional. Exemplo: 2000-01-27

properties
string[]

Uma lista de propriedades separadas por vírgulas para incluir na resposta. Propriedades não reconhecidas são ignoradas. Opcional. Exemplo: hs_name, hs_budget, hs_notes

startDate
string

A data de início para buscar métricas de ativos, no formato AAAA-MM-DD. Opcional. Exemplo: 2000-01-20

Resposta

successful operation

assets
object
obrigatório

Contém os recursos associados à campanha, cada um representado como um conjunto de ativos da campanha.

businessUnits
object[]
obrigatório

Uma matriz de unidades de negócios associadas à campanha, cada uma representada por um objeto PublicBusinessUnit.

createdAt
string<date-time>
obrigatório

A data e a hora de criação da campanha, formatadas como uma string de data e hora.

id
string
obrigatório

O identificador exclusivo da campanha.

properties
object
obrigatório

Um mapa de pares chave-valor representando as propriedades da campanha.

updatedAt
string<date-time>
obrigatório

A data e a hora da última atualização da campanha, formatadas como uma string de data e hora.

Last modified on May 11, 2026