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
​
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

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., [email protected]).

​
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>

Filter for event data that occurred after a specific datetime.

​
occurredBefore
string<date-time>

Filter for event data that occurred before a specific datetime.

​
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).

​
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
​
paging
object
Last modified on December 8, 2025