Pular para o conteúdo principal
POST
/
marketing
/
v3
/
marketing-events
/
attendance
/
{externalEventId}
/
{subscriberState}
/
create
Registrar participantes por ContactId com IDs externos de eventos de marketing
curl --request POST \
  --url https://api.hubapi.com/marketing/v3/marketing-events/attendance/{externalEventId}/{subscriberState}/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "interactionDateTime": 123,
      "properties": {},
      "vid": 123
    }
  ]
}
'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "vid": 123
    }
  ],
  "startedAt": "2023-11-07T05:31:56Z",
  "status": "CANCELED",
  "errors": [
    {
      "category": "<string>",
      "context": {},
      "errors": [
        {
          "message": "<string>",
          "code": "<string>",
          "context": "{missingScopes=[scope1, scope2]}",
          "in": "<string>",
          "subCategory": "<string>"
        }
      ],
      "links": {},
      "message": "<string>",
      "status": "<string>",
      "id": "<string>",
      "subCategory": {}
    }
  ],
  "links": {},
  "numErrors": 123,
  "requestedAt": "2023-11-07T05:31:56Z"
}

Produtos suportados

Requer um dos seguintes produtos ou superior.
Marketing HubMarketing Hub -Grátis
Sales HubSales Hub -Grátis
Service HubService Hub -Grátis
Content HubContent Hub -Grátis

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

externalEventId
string
obrigatório
subscriberState
string
obrigatório

Parâmetros de consulta

externalAccountId
string

Corpo

application/json
inputs
object[]
obrigatório

Lista de contatos do HubSpot para inscrever no evento de marketing

Resposta

successful operation

completedAt
string<date-time>
obrigatório

A data/hora que representa quando o processamento da solicitação foi concluído.

results
object[]
obrigatório
startedAt
string<date-time>
obrigatório

A data/hora que representa o momento em que o processamento da solicitação começou

status
enum<string>
obrigatório

O status do processamento da solicitação

Opções disponíveis:
CANCELED,
COMPLETE,
PENDING,
PROCESSING
errors
object[]

O resultado da solicitação

numErrors
integer<int32>

O número de erros que ocorreram durante o processamento

requestedAt
string<date-time>

A data/hora que representa o momento em que a solicitação foi feita

Last modified on March 24, 2026