Skip to main content

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 guideWhitelabel
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 auhtorizationUrl

Live 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/genericContactList and Search Intercom Contacts
GET/resources/genericContact/:idRetrieve a Intercom Contact
POST/resources/genericContactCreate a Intercom Contact
PATCH/resources/genericContact/:idUpdate a Intercom Contact
DEL/resources/genericContact/:idDelete 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.

view Contact model details

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/genericCompanyList and Search Intercom Companies
GET/resources/genericCompany/:idRetrieve a Intercom Company
POST/resources/genericCompanyCreate a Intercom Company
PATCH/resources/genericCompany/:idUpdate a Intercom Company
DEL/resources/genericCompany/:idDelete 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.

view Company model details

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/genericUserList and Search Intercom Users
GET/resources/genericUser/:idRetrieve a Intercom User
POST/resources/genericUserCreate a Intercom User
PATCH/resources/genericUser/:idUpdate a Intercom User
DEL/resources/genericUser/:idDelete 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.

view User model details

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/genericWorkspaceList and Search Intercom Workspaces
GET/resources/genericWorkspace/:idRetrieve a Intercom Workspace
POST/resources/genericWorkspaceCreate a Intercom Workspace
PATCH/resources/genericWorkspace/:idUpdate a Intercom Workspace
DEL/resources/genericWorkspace/:idDelete 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.

view Workspace model details

​
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/ticketProjectList and Search Intercom Projects
GET/resources/ticketProject/:idRetrieve a Intercom Project
POST/resources/ticketProjectCreate a Intercom Project
PATCH/resources/ticketProject/:idUpdate a Intercom Project
DEL/resources/ticketProject/:idDelete a Intercom Project

view Project model details

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/ticketIssueList and Search Intercom Issues
GET/resources/ticketIssue/:idRetrieve a Intercom Issue
POST/resources/ticketIssueCreate a Intercom Issue
PATCH/resources/ticketIssue/:idUpdate a Intercom Issue
DEL/resources/ticketIssue/:idDelete a Intercom Issue

view Issue model details

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/ticketCommentList and Search Intercom Comments
GET/resources/ticketComment/:idRetrieve a Intercom Comment
POST/resources/ticketCommentCreate a Intercom Comment
PATCH/resources/ticketComment/:idUpdate a Intercom Comment
DEL/resources/ticketComment/:idDelete a Intercom Comment

view Comment model details

​
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/widgetCardViewList and Search Intercom Card Views
GET/resources/widgetCardView/:idRetrieve a Intercom Card View
POST/resources/widgetCardViewCreate a Intercom Card View
PATCH/resources/widgetCardView/:idUpdate a Intercom Card View
DEL/resources/widgetCardView/:idDelete a Intercom Card View

view Card View model details

​
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.
ModelsCreatedUpdatedDeletedAPI Reference
genericContactview event
genericCompanyview event
genericUserview event
genericWorkspaceview event
ticketProjectview event
ticketIssueview event
ticketCommentview event
widgetCardViewview event

​
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.