The intercom API reference.
Home//
REST API Reference
/- Create Data Event Summaries Request
Activity Log
Paginated Response
Activity Log Metadata
Addressable List
Admins
Admin Priority Level
Admin Reply
Admin Reply on ticket
Admin
App
Article Content
Articles
Article Statistics
Article Translated Content
Assign Conversation Request
Assign Conversation Request
Close Conversation Request
Collections
Company Attached Contacts
Company Attached Segments
Companies
Company Scroll
Contact Archived
Contact Attached Companies
Contact companies
Company Data
Contact Deleted
Contact List
Contact Location
Contact notes
Contact Reference
Contact Reply Base Object
Contact Reply
Email
Intercom User ID
Email
Intercom User ID
Contact Reply on ticket
User ID
User ID
Segments
Social Profile
Contact Subscription Types
Contact Tags
Contact Unarchived
Conversation attachment files
Contacts
First contact reply
Conversation List
Conversation Part
Conversation part author
Conversation Parts
Conversation Rating
Conversation source
Conversation statistics
Conversation teammates
Convert Ticket Request Payload
Convert Visitor Request Payload
Create Article Request Payload
Create Collection Request Payload
Create Contact Request Payload
Create Conversation Request Payload
Create Data Attribute Request
Create Data Event Request
Create Data Export Request
Create Message Request Payload
Create Or Update Company Request Payload
Create or Update Tag Request Payload
Create Phone Switch Request Payload
Create Ticket Reply Request Payload
Create Ticket Request Payload
Create Ticket Type Attribute Request Payload
Create Ticket Type Request Payload
Cursor based pages
Custom Attributes
customer_request
Data Attribute List
Data Event List
Data Event Summary
Data Event Summary Item
Data Export CSV
Deleted Article Object
Deleted Collection Object
Deleted Company Object
Deleted Object
detach_contact_from_conversation_request
Error
File
Group Content
Group Translated Content
intercom_version
Linked Object
Linked Objects
Merge contact data
Multiple Filter Search Request
Create News Item Request
Paginated Response
Open Conversation Request
Pagination Object
Paginated Response
Part attachment
Phone Switch
redact_conversation_request
Reference
reply_conversation_request
Search data
Segment List
Single Filter Search Request
Applied SLA
Snooze Conversation Request
Social Profile
Pagination: Starting After
Subscription Types
Tag Company Request Payload
Tags
Tag Users Request Payload
Tags
Team List
Team Priority Level
Ticket Attributes
Ticket List
Ticket part author
Ticket Parts
A Ticket Part representing a note, comment, or quick_reply on a ticket
Ticket Attributes
Ticket Type Attribute
Ticket Type Attributes
Ticket Types
Translation
Untag Company Request Payload
Update Article Request Payload
Update Collection Request Payload
Update Contact Request Payload
Update Conversation Request
Update Data Attribute Request
Update Ticket Request Payload
Update Ticket Type Attribute Request Payload
Update Ticket Type Request Payload
Update Visitor Request Payload
Visitor
Visitor Deleted Object
Create Data Event Summari...
Intercom API (2.10)
Download OpenAPI description
Overview
URL
License
Languages
Servers
The production API server
https://api.intercom.io/
The european API server
https://api.eu.intercom.io/
The australian API server
https://api.au.intercom.io/
Create Data Event Request
Any of:
The name of the event that occurred. This is presented to your App's admins when filtering and creating segments - a good event name is typically a past tense 'verb-noun' combination, to improve readability, for example updated-plan.
Example: "invited-friend"
The time the event occurred as a UTC Unix timestamp
Example: 1671028894
The unique identifier for the contact (lead or user) which is given by Intercom.
Example: "8a88a590-e1c3-41e2-a502-e0649dbf721c"
An email address for your user. An email should only be used where your application uses email to uniquely identify users.
Example: "frodo.baggins@example.com"
{ "event_name": "invited-friend", "created_at": 1671028894, "user_id": "314159", "id": "8a88a590-e1c3-41e2-a502-e0649dbf721c", "email": "frodo.baggins@example.com", "metadata": { "invite_code": "ADDAFRIEND" } }
Create Data Event Summaries Request
You can send a list of event summaries for a 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.
{ "user_id": "314159", "event_summaries": { "event_name": "invited-friend", "count": 1, "first": 1671028894, "last": 1671028894 } }