Intercom

Intercom node reference - all 161 operations, the credential it needs, and a worked example.

Intercom REST API (Support desk). 161 operations: contacts, companies and their memberships; conversations — reply, note, close, snooze, assign, redact and convert to ticket; tickets, ticket types and attributes; tags across contacts, conversations, tickets, companies and users; notes; admins, teams and activity logs; events and data attributes; segments and subscription types; Help Center articles, collections and Help Centers; internal articles; news items and newsfeeds; outbound messages, SMS Switch and visitors; custom object instances; Fin AI content sources and external pages; calls; content data exports, jobs, brands, email settings and the IP allowlist.

Credential: Intercom access token - see Credentials.

Permissions

Each operation below lists the permission it needs. Permissions are ticked on the app's Authentication page in Intercom's Developer Hub (Settings → Developer Hub → your app → Authentication), and granted by the workspace admin when an OAuth app is installed. Every value below is one of Intercom's own permission LABELS, copied verbatim from its published OAuth scopes table - that is the string a user has to find and tick, and it reads nothing like an OAuth scope token. Three things to know before reading a row. Intercom publishes no endpoint→permission map, so each row names the permission whose own published description covers that operation, and the handful of operations no published permission names at all say so in parentheses rather than inventing one. A token minted for your OWN workspace already carries every permission the app declares, so a 403 there is almost never an unticked box - it is the workspace's PLAN (tickets, Fin AI content, calls, custom object instances and the IP allowlist are all plan-gated) or a seat/role limit. And Intercom's own wording undersells two labels: Write tickets is the whole ticket write surface rather than only creation, and Read and list users and companies covers segments and the data-attribute schema as well as people. If a run fails with a permission error, the node names the missing permission in the error - grant it and re-run; you do not need to rebuild the workflow.

Operations (161)

Contacts

Operation	What it does	Permission
`createOrUpdateContact`	Create or update contact (by email)	`Write users and companies`
`createContact`	Create contact	`Write users and companies`
`updateContact`	Update contact	`Write users and companies`
`getContact`	Get contact	`Read and list users and companies`
`getContactByExternalId`	Get contact by external ID	`Read and list users and companies`
`deleteContact`	Delete contact	`Write users and companies`
`listContacts`	List contacts	`Read and list users and companies`
`searchContacts`	Search contacts by email	`Read and list users and companies`
`searchContactsAdvanced`	Search contacts (query JSON)	`Read and list users and companies`
`mergeContacts`	Merge a lead into a user	`Read and write users`
`archiveContact`	Archive contact	`Write users and companies`
`unarchiveContact`	Unarchive contact	`Write users and companies`
`blockContact`	Block contact	`Write users and companies`
`listContactCompanies`	List a contact's companies	`Read and list users and companies`
`listContactSegments`	List a contact's segments	`Read and list users and companies`
`listContactTags`	List a contact's tags	`Read tags`
`listContactSubscriptions`	List a contact's subscriptions	`Read and list users and companies`
`listContactNotes`	List a contact's notes	`Read and list users and companies`

Companies

Operation	What it does	Permission
`upsertCompany`	Create or update company	`Write users and companies`
`updateCompany`	Update company	`Write users and companies`
`getCompany`	Get company by Intercom ID	`Read and list users and companies`
`findCompanies`	Find companies (by name / company_id / tag / segment)	`Read and list users and companies`
`listCompanies`	List all companies	`Read and list users and companies`
`scrollCompanies`	Scroll through all companies	`Read and list users and companies`
`deleteCompany`	Delete company	`Write users and companies`
`listCompanyContacts`	List a company's contacts	`Read and list users and companies`
`listCompanySegments`	List a company's segments	`Read and list users and companies`
`listCompanyNotes`	List a company's notes	`Read and list users and companies`
`attachContactToCompany`	Attach contact to company	`Read and write users`
`detachContactFromCompany`	Detach contact from company	`Read and write users`

Conversations

Operation	What it does	Permission
`listConversations`	List conversations	`Read conversations`
`getConversation`	Get conversation	`Read conversations`
`createConversation`	Start a conversation (as a contact)	`Write conversations`
`updateConversation`	Update conversation	`Write conversations`
`deleteConversation`	Delete conversation	`Delete conversations and metrics`
`searchConversations`	Search conversations (query JSON)	`Read conversations`
`replyConversation`	Reply to conversation as admin	`Write conversations`
`addConversationNote`	Add a private note to a conversation	`Write conversations`
`replyConversationAsContact`	Reply to conversation as the contact	`Write conversations`
`closeConversation`	Close conversation	`Write conversations`
`openConversation`	Reopen conversation	`Write conversations`
`snoozeConversation`	Snooze conversation	`Write conversations`
`assignConversation`	Assign conversation	`Write conversations`
`attachContactToConversation`	Add a contact to a conversation	`Write conversations`
`detachContactFromConversation`	Remove a contact from a conversation	`Write conversations`
`redactConversationPart`	Redact a conversation part or source	`Write conversations`
`convertConversationToTicket`	Convert conversation to ticket	`Write tickets`
`listConversationHandlingEvents`	List conversation handling events	`Read conversations`

Tickets

Operation	What it does	Permission
`createTicket`	Create ticket	`Write tickets`
`enqueueCreateTicket`	Create ticket (async, enqueued)	`Write tickets`
`getTicket`	Get ticket	`Read tickets`
`updateTicket`	Update ticket	`Write tickets`
`deleteTicket`	Delete ticket	`Write tickets`
`searchTickets`	Search tickets (query JSON)	`Read tickets`
`replyTicket`	Reply to ticket as admin	`Write tickets`
`listTicketStates`	List ticket states	`Read tickets`

Ticket types

Operation	What it does	Permission
`listTicketTypes`	List ticket types	`Read tickets`
`createTicketType`	Create ticket type	`Write tickets`
`getTicketType`	Get ticket type	`Read tickets`
`updateTicketType`	Update ticket type	`Write tickets`
`createTicketTypeAttribute`	Create ticket type attribute	`Write tickets`
`updateTicketTypeAttribute`	Update ticket type attribute	`Write tickets`

Operation	What it does	Permission
`listTags`	List tags	`Read tags`
`getTag`	Get tag	`Read tags`
`createOrUpdateTag`	Create or rename tag	`Write tags`
`deleteTag`	Delete tag	`Write tags`
`tagContact`	Tag a contact (by tag name)	`Write tags`
`untagContact`	Remove tag from contact	`Write tags`
`tagConversation`	Tag a conversation	`Write tags`
`untagConversation`	Remove tag from conversation	`Write tags`
`tagTicket`	Tag a ticket	`Write tags`
`untagTicket`	Remove tag from ticket	`Write tags`
`tagCompanies`	Tag companies	`Write tags`
`untagCompanies`	Untag companies	`Write tags`
`tagUsers`	Tag users	`Write tags`

Notes

Operation	What it does	Permission
`createNote`	Create note on a contact	`Write users and companies`
`getNote`	Get note	`Read and list users and companies`

Admins & teams

Operation	What it does	Permission
`getCurrentAdmin`	Identify the token's admin / workspace	`Read admins`
`listAdmins`	List admins	`Read admins`
`getAdmin`	Get admin	`Read one admin`
`setAdminAway`	Set an admin away / back	`Update admins`
`listAwayStatusReasons`	List away status reasons	`Read admins`
`listActivityLogs`	List admin activity logs	`Read admin activity logs`
`listTeams`	List teams	`Read admins`
`getTeam`	Get team	`Read admins`

Events & data attributes

Operation	What it does	Permission
`trackEvent`	Track an event	`Write events`
`listEvents`	List a contact's events	`Read events`
`createEventSummaries`	Create event summaries	`Write events`
`listDataAttributes`	List data attributes	`Read and list users and companies`
`createDataAttribute`	Create data attribute	`Write data attributes`
`updateDataAttribute`	Update / archive data attribute	`Write data attributes`

Segments & subscriptions

Operation	What it does	Permission
`listSegments`	List segments	`Read and list users and companies`
`getSegment`	Get segment	`Read and list users and companies`
`listSubscriptionTypes`	List subscription types	`Read and list users and companies`
`addSubscription`	Add subscription to contact	`Write users and companies`
`removeSubscription`	Remove subscription from contact	`Write users and companies`

Help Center: articles

Operation	What it does	Permission
`listArticles`	List articles	`Read and List articles`
`createArticle`	Create article	`Read and Write Articles`
`getArticle`	Get article	`Read and List articles`
`updateArticle`	Update article	`Read and Write Articles`
`deleteArticle`	Delete article	`Read and Write Articles`
`searchArticles`	Search articles	`Read and List articles`

Help Center: collections

Operation	What it does	Permission
`listCollections`	List collections	`Read and List articles`
`createCollection`	Create collection	`Read and Write Articles`
`getCollection`	Get collection	`Read and List articles`
`updateCollection`	Update collection	`Read and Write Articles`
`deleteCollection`	Delete collection	`Read and Write Articles`
`listHelpCenters`	List Help Centers	`Read and List articles`
`getHelpCenter`	Get Help Center	`Read and List articles`

Internal articles

Operation	What it does	Permission
`listInternalArticles`	List internal articles	`Read and List articles`
`createInternalArticle`	Create internal article	`Read and Write Articles`
`getInternalArticle`	Get internal article	`Read and List articles`
`updateInternalArticle`	Update internal article	`Read and Write Articles`
`deleteInternalArticle`	Delete internal article	`Read and Write Articles`
`searchInternalArticles`	Search internal articles	`Read and List articles`

News

Operation	What it does	Permission
`listNewsItems`	List news items	`Read and List news items and newsfeeds`
`createNewsItem`	Create news item	`Read and Write news items and newsfeeds`
`getNewsItem`	Get news item	`Read and List news items and newsfeeds`
`updateNewsItem`	Update news item	`Read and Write news items and newsfeeds`
`deleteNewsItem`	Delete news item	`Read and Write news items and newsfeeds`
`listNewsfeeds`	List newsfeeds	`Read and List news items and newsfeeds`
`getNewsfeed`	Get newsfeed	`Read and List news items and newsfeeds`
`listNewsfeedItems`	List live newsfeed items	`Read and List news items and newsfeeds`

Messages & visitors

Operation	What it does	Permission
`createMessage`	Send an outbound message	`Write conversations`
`createPhoneSwitch`	Send an SMS Switch to a phone number	`Create phone call redirects`
`getVisitor`	Get visitor by user ID	`Read and list users and companies`
`updateVisitor`	Update visitor	`Write users and companies`
`convertVisitor`	Convert visitor to contact	`Write users and companies`

Custom object instances

Operation	What it does	Permission
`upsertCustomObjectInstance`	Create or update custom object instance	`Read and write custom object instances`
`getCustomObjectInstance`	Get custom object instance by ID	`Read and write custom object instances`
`getCustomObjectInstanceByExternalId`	Get custom object instance by external ID	`Read and write custom object instances`
`deleteCustomObjectInstance`	Delete custom object instance by ID	`Read and write custom object instances`
`deleteCustomObjectInstanceByExternalId`	Delete custom object instance by external ID	`Read and write custom object instances`

AI content (Fin)

Operation	What it does	Permission
`listContentImportSources`	List content import sources	`Read and write AI content`
`createContentImportSource`	Create content import source	`Read and write AI content`
`getContentImportSource`	Get content import source	`Read and write AI content`
`updateContentImportSource`	Update content import source	`Read and write AI content`
`deleteContentImportSource`	Delete content import source	`Read and write AI content`
`listExternalPages`	List external pages	`Read and write AI content`
`createExternalPage`	Create or update external page	`Read and write AI content`
`getExternalPage`	Get external page	`Read and write AI content`
`updateExternalPage`	Update external page	`Read and write AI content`
`deleteExternalPage`	Delete external page	`Read and write AI content`
`startFinConversation`	Start a conversation with Fin	`Write conversations`
`replyToFin`	Reply to Fin	`Write conversations`

Calls

Operation	What it does	Permission
`listCalls`	List calls	`Read conversations`
`getCall`	Get call	`Read conversations`
`getCallRecording`	Get call recording	`Read conversations`
`getCallTranscript`	Get call transcript	`Read conversations`
`searchCallTranscripts`	List calls with transcripts	`Read conversations`

Exports, jobs & workspace

Operation	What it does	Permission
`createContentDataExport`	Start a content data export	`Export content data`
`getContentDataExport`	Get content data export status	`Export content data`
`cancelContentDataExport`	Cancel content data export	`Export content data`
`getJobStatus`	Get job status	`Read status of jobs`
`exportWorkflow`	Export a workflow	(no published permission — workspace configuration read)
`listBrands`	List brands	(no published permission — workspace configuration read)
`getBrand`	Get brand	(no published permission — workspace configuration read)
`listEmailSettings`	List email settings	(no published permission — workspace configuration read)
`getEmailSetting`	Get email setting	(no published permission — workspace configuration read)
`getIpAllowlist`	Get IP allowlist	(no published permission — workspace security settings)
`updateIpAllowlist`	Update IP allowlist	(no published permission — workspace security settings)

On this page