For a given portal, return the list of marketing events.
| Required Parameters | How to use | Description |
|---|---|---|
| HubSpot OAuth Access Token | access_token=X - Used in the request URL | The HubSpot API key for the portal that you're making the call for. |
| Optional Parameters | How to use | Description |
|---|---|---|
| Max | &max=X - Used in the request URL | The number of marketing events you want returned to you. |
Example URL using JSON: https://api.hubapi.com/events/v1/events?access_token=demooooo-oooo-oooo-oooo-oooooooooooo&max=3
Example JSON output. It's displaying 3 events from the HubSpot demo portal:
[
{
"createDate": 1322620584000,
"description": "This is my test event",
"eventType": "test",
"portalId": 62515,
"url": "http://www.test.com",
"createdBy": "api"
},
{
"createDate": 1322598486000,
"description": "Updated title",
"eventType": "bizblogger",
"portalId": 62515,
"url": "http://demo.hubapi.com/blog-for-testing/bid/80149/updated-title",
"createdBy": "testapi@hubspot.com"
},
{
"createDate": 1322510037000,
"description": "This is my test event",
"eventType": "test",
"portalId": 62515,
"url": "http://www.test.com",
"createdBy": "api"
}
]
HTTP Methods:
GET
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers