Intercom
Open-Source Intercom Connector
Intercom
The Intercom connector enables easy and secure data synchronization between your application and your customers’ Intercom accounts through unified data models.
Authorization
The Intercom connector uses OAuth for secure authentication. When creating a connection, the required OAuth scopes are automatically configured based on your specific operations needs (e.g. genericContact::create, genericUser::list).
✓ Automatic token refresh handling
✓ Proactive insufficient permissions detection
View our step-by-step integration guide
Whitelabel
Supported
You can choose to provide your own set of clientId and clientSecret for this
connector from the Morph Cloud dashboard; allowing a fully whitelabled experience
for your end-customers.
import { Morph } from "@runmorph/cloud";
const morph = Morph({ publicKey: "pk_demo_xxxxxxxxxxxxxxx", secretKey: "sk_demo_xxxxxxxxxxxxxxx"});
// create a new connection
const connection = morph.connections({ connectorId: "intercom", ownerId: "demo" });
await connection.create({ operations:[ "genericContact::list" ]});
// auhtorize the connection
const { auhtorizationUrl } = await connection.authorize();
// redirect the user to the auhtorizationUrlLive Demo
Select a connector below to experience our seamless authentication flow and see
how easy it is to connect third-party services.
Models
Generic
The Intercom connector seamlessly integrates with our unified genericContact model, enabling you to manage Contacts with rich data including firstName, lastName, phoneNumber, email and other key details
API Reference
| GET | /resources/genericContact | List and Search Intercom Contacts |
| GET | /resources/genericContact/:id | Retrieve a Intercom Contact |
| POST | /resources/genericContact | Create a Intercom Contact |
| PATCH | /resources/genericContact/:id | Update a Intercom Contact |
| DEL | /resources/genericContact/:id | Delete a Intercom Contact |
Custom Fields
Supported
The Intercom connector supports our Field Mapping feature, enabling you or your customers to seamlessly map Intercom Contact custom fields to the unified contact model. This allows for flexible data synchronization while maintaining data consistency across all connectors.
The Intercom connector seamlessly integrates with our unified genericCompany model, enabling you to manage Companies with rich data including name and other key details
API Reference
| GET | /resources/genericCompany | List and Search Intercom Companies |
| GET | /resources/genericCompany/:id | Retrieve a Intercom Company |
| POST | /resources/genericCompany | Create a Intercom Company |
| PATCH | /resources/genericCompany/:id | Update a Intercom Company |
| DEL | /resources/genericCompany/:id | Delete a Intercom Company |
Custom Fields
Supported
The Intercom connector supports our Field Mapping feature, enabling you or your customers to seamlessly map Intercom Company custom fields to the unified company model. This allows for flexible data synchronization while maintaining data consistency across all connectors.
The Intercom connector seamlessly integrates with our unified genericUser model, enabling you to manage Users with rich data including firstName, lastName, email and other key details
API Reference
| GET | /resources/genericUser | List and Search Intercom Users |
| GET | /resources/genericUser/:id | Retrieve a Intercom User |
| POST | /resources/genericUser | Create a Intercom User |
| PATCH | /resources/genericUser/:id | Update a Intercom User |
| DEL | /resources/genericUser/:id | Delete a Intercom User |
Custom Fields
Supported
The Intercom connector supports our Field Mapping feature, enabling you or your customers to seamlessly map Intercom User custom fields to the unified user model. This allows for flexible data synchronization while maintaining data consistency across all connectors.
The Intercom connector seamlessly integrates with our unified genericWorkspace model, enabling you to manage Workspaces with rich data including name and other key details
API Reference
| GET | /resources/genericWorkspace | List and Search Intercom Workspaces |
| GET | /resources/genericWorkspace/:id | Retrieve a Intercom Workspace |
| POST | /resources/genericWorkspace | Create a Intercom Workspace |
| PATCH | /resources/genericWorkspace/:id | Update a Intercom Workspace |
| DEL | /resources/genericWorkspace/:id | Delete a Intercom Workspace |
Custom Fields
Supported
The Intercom connector supports our Field Mapping feature, enabling you or your customers to seamlessly map Intercom Workspace custom fields to the unified workspace model. This allows for flexible data synchronization while maintaining data consistency across all connectors.
Ticketing
The Intercom connector seamlessly integrates with our unified ticketProject model, enabling you to manage Projects with rich data including name, description, members and other key details
API Reference
| GET | /resources/ticketProject | List and Search Intercom Projects |
| GET | /resources/ticketProject/:id | Retrieve a Intercom Project |
| POST | /resources/ticketProject | Create a Intercom Project |
| PATCH | /resources/ticketProject/:id | Update a Intercom Project |
| DEL | /resources/ticketProject/:id | Delete a Intercom Project |
The Intercom connector seamlessly integrates with our unified ticketIssue model, enabling you to manage Issues with rich data including project, title, description, status, priority and other key details
API Reference
| GET | /resources/ticketIssue | List and Search Intercom Issues |
| GET | /resources/ticketIssue/:id | Retrieve a Intercom Issue |
| POST | /resources/ticketIssue | Create a Intercom Issue |
| PATCH | /resources/ticketIssue/:id | Update a Intercom Issue |
| DEL | /resources/ticketIssue/:id | Delete a Intercom Issue |
The Intercom connector seamlessly integrates with our unified ticketComment model, enabling you to manage Comments with rich data including issue, author, content, isInternal and other key details
API Reference
| GET | /resources/ticketComment | List and Search Intercom Comments |
| GET | /resources/ticketComment/:id | Retrieve a Intercom Comment |
| POST | /resources/ticketComment | Create a Intercom Comment |
| PATCH | /resources/ticketComment/:id | Update a Intercom Comment |
| DEL | /resources/ticketComment/:id | Delete a Intercom Comment |
Widget
The Intercom connector seamlessly integrates with our unified widgetCardView model, enabling you to manage Card Views with rich data including and other key details
API Reference
| GET | /resources/widgetCardView | List and Search Intercom Card Views |
| GET | /resources/widgetCardView/:id | Retrieve a Intercom Card View |
| POST | /resources/widgetCardView | Create a Intercom Card View |
| PATCH | /resources/widgetCardView/:id | Update a Intercom Card View |
| DEL | /resources/widgetCardView/:id | Delete a Intercom Card View |
Custom
Supported
Can’t find the unified model you need? The Intercom connector supports your own custom model.
Webhooks
The Intercom connector supports real-time event subscriptions, allowing you to receive instant notifications when records are created, updated, or deleted. Below are the supported models and their corresponding triggers.
| Models | Created | Updated | Deleted | API Reference |
|---|---|---|---|---|
genericContact | ||||
genericCompany | ||||
genericUser | ||||
genericWorkspace | ||||
ticketProject | ||||
ticketIssue | ||||
ticketComment | ||||
widgetCardView |
Proxy
Supported
The Intercom connector supports our Proxy Request feature, allowing you to directly
call any endpoints from Intercom’s public API without needing to handle authentication.
Your customer’s token will be automatically set and refreshed as needed, enabling
quick implementation of custom connector behaviors. View API Reference.