Home
/
REST API Reference
/
Data Events
/
Create event summaries

Create event summaries

Create event summaries for a user. Event summaries are used to track the number of times an event has occurred, the first time it occurred and the last time it occurred.

SecurityHTTP: bearerAuth
Request
header Parameters
Intercom-Version
string (intercom_version)
Default: 2.10

Intercom API version.
By default, it's equal to the version set in the app package.

Enum: "1.0" "1.1" "1.2" "1.3" "1.4" "2.0" "2.1" "2.2" "2.3" "2.4" "2.5" "2.6" "2.7" "2.8" "2.9" "2.10" "Unstable"
Example: 2.10
Request Body schema: application/json
user_id
string

Your identifier for the user.

object

A list of event summaries for the user. Each event summary should contain the event name, the time the event occurred, and the number of times the event occurred. The event name should be a past tense 'verb-noun' combination, to improve readability, for example updated-plan.

post
/events/summaries
Request samples
application/json
{
"user_id": "314159",
"event_summaries": {
"event_name": "invited-friend",
"count": 1,
"first": 1671028894,
"last": 1671028894
}
}
Responses

200

successful

401

Unauthorized

Response samples
application/json
{
"type": "error.list",
"request_id": "fe2891d3-0fc1-465e-927b-7135a8b1c9cd",
"errors": [

]
}