DocsBuilding AppsInstalling IntercomAPI & Webhook ReferenceCanvas Kit Reference
DocsApp StoreForumBlogYour Apps

View User Event Summaries

Get summary count of user events

$ curl 'https://api.intercom.io/events?type=user&user_id=314159&summary=true' \
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept: application/json'
{
    "type": "event.summary",
    "email": "[email protected]",
    "intercom_user_id": "56e1e5d4a40df1cc57000101",
    "user_id": "314159",
    "events": [
        {
            "name": "updated-profile",
            "first": "2016-03-18T10:05:15.000Z",
            "last": "2016-03-18T13:28:38.000Z",
            "count": 5,
            "description": null
        },    
        {
            "name": "purchased-item",
            "first": "2016-09-30T11:39:06.000Z",
            "last": "2016-09-30T11:39:06.000Z",
            "count": 4,
            "description": null
        },
        {
            "name": "subscribed-for-demo",
            "first": "2016-11-24T12:26:34.000Z",
            "last": "2016-11-24T12:26:34.000Z",
            "count": 2,
            "description": null
        }
    ]
}

If you simply want to get a count of the number of different events associated with a user then you can use the 'summary=true' parameter of the events endpoint. This means you do not receive the full list of all users events and just the counts of the different events per user.