Passer au contenu principal
GET
/
events
/
v3
/
events
Demande d'instance d'événement
curl --request GET \
  --url https://api.hubapi.com/events/v3/events/ \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "eventType": "<string>",
      "id": "<string>",
      "objectId": "<string>",
      "objectType": "<string>",
      "occurredAt": "2023-11-07T05:31:56Z",
      "properties": {}
    }
  ],
  "paging": {
    "next": {
      "after": "<string>",
      "link": "<string>"
    },
    "prev": {
      "before": "<string>",
      "link": "<string>"
    }
  }
}

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing Hub -Entreprise
Sales HubSales Hub -Entreprise
Service HubService Hub -Entreprise
Content HubContent Hub -Entreprise

Autorisations

​
Authorization
string
header
requis

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

Paramètres de requête

​
after
string

Le jeton de curseur de pagination de la dernière ressource lue avec succès sera renvoyé en tant que propriété JSON « paging.next.after » d'une réponse paginée contenant plus de résultats.

​
before
string

Paging cursor token from paging.prev.before in a previous response. Use to retrieve the previous page of results.

​
eventType
string

Le nom du type d'événement. La liste des noms de types d'événements disponibles peut être obtenue à partir d'un autre appel d'API.

​
id
string[]

ID d'une instance d'événement. Les ID sont individuels pour les instances d'événements. Si vous fournissez ce filtre et des filtres supplémentaires, les autres filtres doivent correspondre aux valeurs figurant sur l'instance d'événement pour donner des résultats.

​
limit
integer<int32>

Le nombre maximum de résultats à afficher par page.

​
objectId
integer<int64>

L'ID du filtre d'objet CRM sur lequel filtrer des instances d'événement. Si vous filtrez à partir d'un objectId, vous devez également fournir un objectType.

​
objectProperty.{propname}
object

Filter events by a property on the associated CRM object. Replace {propname} with the property name (e.g. objectProperty.email=user@example.com). Multiple filters are ANDed together.

​
objectType
string

Le nom du type d'objet CRM à partir duquel filtrer les instances d'objets. Vous pouvez également si vous le souhaitez fournir un objectId dans un autre paramètre pour filtrer à partir d'une instance d'objet CRM spécifique.

​
occurredAfter
string<date-time>

Return only events that occurred after this timestamp, in ISO 8601 format (e.g. 2024-01-01T00:00:00Z).

​
occurredBefore
string<date-time>

Return only events that occurred before this timestamp, in ISO 8601 format (e.g. 2024-12-31T23:59:59Z).

​
property.{propname}
object

Filter events by a property on the event itself. Replace {propname} with the event property name. Multiple values for the same property are ORed; multiple properties are ANDed. Requires eventType to be set.

​
sort
string[]

Triez la direction en fonction de l'horodatage de l'instance d'événement, CROISSANT ou DÉCROISSANT.

Réponse

successful operation

​
results
object[]
requis

An array of ExternalUnifiedEvent objects, each representing an individual event with its associated details.

​
paging
object
Last modified on February 12, 2026