GET
/
events
/
v3
/
events
/
Consulta de instancia del evento
curl --request GET \
  --url https://api.hubapi.com/events/v3/events/ \
  --header 'Authorization: Bearer <token>'
{
  "paging": {
    "next": {
      "link": "",
      "after": ""
    },
    "prev": {
      "before": "",
      "link": ""
    }
  },
  "results": [
    {
      "occurredAt": "2023-11-07T05:31:56Z",
      "eventType": "<string>",
      "id": "<string>",
      "objectId": "<string>",
      "properties": {},
      "objectType": "<string>"
    }
  ]
}
Productos compatibles
Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing HubEnterprise
Sales HubSales HubEnterprise
Service HubService HubEnterprise
Content HubContent HubEnterprise

Ámbitos Requeridos

Esta API requiere uno de los siguientes ámbitos:
  • oauth

Authorizations

Authorization
string
header
required

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

Query Parameters

objectType
string

El nombre del tipo de objeto CRM para filtrar las instancias de eventos. Opcionalmente, también puedes proporcionar un objectId en otro parámetro para filtrar a una instancia específica de objeto CRM.

eventType
string

El nombre del tipo de evento. Se puede obtener una lista de nombres de tipos de eventos de otra llamada a la API.

after
string

El token del cursor de paginación del último recurso leído con éxito se devolverá como la propiedad JSON "paging.next.after" de una respuesta paginada que contenga más resultados.

before
string
limit
integer

El número máximo de resultados que se mostrarán por página.

sort
string[]

Dirección de ordenación basada en la marca de tiempo de la instancia del evento, ASCENDENTE o DESCENDENTE.

occurredAfter
string<date-time>

Filter for event data that occurred after a specific datetime.

occurredBefore
string<date-time>

Filter for event data that occurred before a specific datetime.

objectId
integer

El ID del objeto CRM para filtrar las instancias de eventos. Si se filtra con objectId, también debes proporcionar un objectType.

objectProperty.{propname}
object

Instead of retrieving event data for a specific object by its ID, you can specify a unique identifier property. For contacts, you can use the email property. (e.g., objectProperty.email=name@domain.com).

property.{propname}
object

Filter for event completions that contain a specific value for an event property (e.g., property.hs_city=portland). For properties values with spaces, replaces spaces with %20 or + (e.g., property.hs_city=new+york).

id
string[]

ID de una instancia de evento. Los IDs se asignan de manera individual a las instancias de eventos. Si proporcionas este filtro y filtros adicionales, los otros filtros deben coincidir con los valores de la instancia de evento para obtener resultados.

Response

200
application/json

successful operation

The response is of type object.