Intercom
for LuumenAI
Read Intercom conversations and tickets, then route or tag them with approval.
Connect Intercom and your agent can pull up a conversation, a ticket, or a contact record while you are still in the terminal. It reads the full message history, the tags, and the ticket type without asking. When something needs to change — an assignment, a tag, a subscription — it shows you the call first and waits for your approval by default. Access uses OAuth2.
The Intercom toolbox
132 tools: 67 read, 65 write. Reads answer instantly. Writes require approval by default. Everything is logged.
- ReadCreate data exportInitiate an async data export job for message content.
- ReadDownload data exportDownload content data export from Intercom.
- ReadFind a tagRetrieve details for a specific tag by its ID.
- ReadGet a contactYou can fetch the details of a single contact.
- ReadGet content import sourceRetrieve a content import source by its ID.
- ReadGet conversationRetrieves a specific conversation by ID with all messages and details.
- ReadGet entity countsRetrieve summary counts for Intercom app entities including companies, users, leads, tags, segments, and conversations.
- ReadGet custom object instance by external IDRetrieve a custom object instance by its external_id.
- ReadGet external pageRetrieve an external page from Fin Content Library by ID.
- ReadGet ticketRetrieve a ticket from Intercom.
- ReadGet a ticket typeRetrieve details for a specific ticket type by its ID.
- ReadIdentify an adminYou can view the currently authorised admin along with the embedded app object (a "workspace" in legacy terminology).
- ReadRetrieve job statusRetrieve the status of job execution.
- ReadList all activity logsYou can get a log of activities by all admins in an app.
- ReadList all adminsYou can fetch a list of admins for a given workspace.
- ReadList all articlesYou can fetch a list of all articles by making a GET request to `https://api.intercom.io/articles`.
- ReadList all collectionsYou can fetch a list of all collections by making a GET request to `https://api.intercom.io/help_center/collections`.
- ReadList all companiesYou can list companies.
- ReadList all help centersYou can list all Help Centers by making a GET request to `https://api.intercom.io/help_center/help_centers`.
- ReadList all macrosFetch a list of all macros (saved replies) in your workspace for use in automating responses.
- ReadList all notesYou can fetch a list of notes that are associated to a contact.
- ReadList attached companies for contactYou can fetch a list of companies that are associated to a contact.
- ReadList attached contactsYou can fetch a list of all contacts that belong to a company.
- ReadList attached segments for companiesYou can fetch a list of all segments that belong to a company.
- ReadList attached segments for contactYou can fetch a list of segments that are associated to a contact.
- ReadList away status reasonsRetrieve all away status reasons for a workspace including deleted ones.
- ReadList callsList all phone calls from Intercom with pagination support.
- ReadList calls with transcriptsRetrieve calls by conversation IDs with transcripts when available.
- ReadList company notesList all notes associated with a specific company.
- ReadList all contactsList all contacts (users or leads) in your Intercom workspace with pagination support.
- ReadList content import sourcesRetrieve all content import sources for the workspace.
- ReadList conversationsLists all conversations from Intercom with pagination support.
- ReadList data attributesList all data attributes for contacts, companies, and conversations.
- ReadList data eventsRetrieve a log of data events belonging to a customer.
- ReadList external pagesList all external pages from Fin Content Library.
- ReadList help center sectionsFetch a list of all help center sections in descending order by updated_at.
- ReadList internal articlesFetches one page of internal articles from Intercom.
- ReadList all news itemsFetch a list of all news items from Intercom.
- ReadList all segmentsRetrieve all segments defined within a workspace for filtering and categorizing contacts.
- ReadList subscriptions for a contactYou can fetch a list of subscription types that are attached to a contact.
- ReadList subscription typesList all subscription types available in the workspace.
- ReadList all tagsFetch all tags for the workspace.
- ReadList tags attached to a contactYou can fetch a list of all tags that are attached to a specific contact.
- ReadList all teamsRetrieve all teams within a workspace.
- ReadList all ticket statesFetch all ticket states for the workspace.
- ReadList all ticket typesRetrieve all ticket types for the workspace.
- ReadRetrieve a collectionYou can fetch the details of a single collection by making a GET request to `https://api.intercom.io/help_center/collections/<id>`.
- ReadRetrieve a company by idYou can fetch a single company.
- ReadRetrieve a help centerYou can fetch the details of a single Help Center by making a GET request to `https://api.intercom.io/help_center/help_center/<id>`.
- ReadRetrieve a macroFetch a single macro (saved reply) by its ID.
- ReadRetrieve an adminYou can retrieve the details of a single admin.
- ReadRetrieve an articleYou can fetch the details of a single article by making a GET request to `https://api.intercom.io/articles/<id>`.
- ReadRetrieve a segmentRetrieve details for a single segment by its ID.
- ReadRetrieve companiesYou can fetch a single company by passing in `company_id` or `name`.
- ReadRetrieve internal articleRetrieve an internal article by ID from Intercom.
- ReadRetrieve noteRetrieve details of a single note by its identifier.
- ReadRetrieve a teamRetrieve detailed information about a specific team by ID.
- ReadRetrieve visitor with user IDRetrieve a specific visitor's details using their user_id.
- ReadScroll over all companiesThe `list all companies` functionality does not work well for huge datasets, and can result in errors and performance problems when paging deeply.
- ReadSearch contactsSearch for contacts using query filters with operators.
- ReadSearch conversationsSearches for conversations using query string with support for filtering and sorting
- ReadSearch for articlesYou can search for articles by making a GET request to `https://api.intercom.io/articles/search`.
- ReadSearch internal articlesSearches one page of internal articles in Intercom.
- ReadSearch ticketsSearch tickets in Intercom by filtering attribute values.
- ReadShow callRetrieve a single call by ID from Intercom.
- ReadShow call transcriptGet call transcript by call ID.
- ReadShow contact by external IDRetrieve a contact by their external ID.
- WriteAdd subscription to a contactYou can add a specific subscription to a contact. Approval by default
- WriteAdd tag to contactAdd a tag to a contact in Intercom. Approval by default
- WriteArchive contactArchive a single contact in Intercom. Approval by default
- WriteAssign conversationAssigns a conversation to a specific admin or team in Intercom. Approval by default
- WriteAttach contact to companyAttach a contact to a company in Intercom. Approval by default
- WriteAttach contact to conversationAttach a contact participant to a conversation on behalf of admin or contact. Approval by default
- WriteAttach tag to conversationAdd a tag to a specific conversation in Intercom. Approval by default
- WriteAttach tag to ticketAdd a tag to a ticket in Intercom. Approval by default
- WriteBlock contactBlock a single contact in Intercom. Approval by default
- WriteCancel data exportCancel an active content data export job. Approval by default
- WriteClose conversationCloses a conversation in Intercom, marking it as resolved. Approval by default
- WriteCreate a collectionYou can create a new collection by making a POST request to `https://api.intercom.io/help_center/collections.` Approval by default
- WriteCreate an articleYou can create a new article by making a POST request to `https://api.intercom.io/articles`. Approval by default
- WriteCreate a noteYou can add a note to a single contact. Approval by default
- WriteCreate contactCreate a new contact in Intercom workspace. Approval by default
- WriteCreate content import sourceCreate a new content import source for the Fin Content Library. Approval by default
- WriteCreate conversationCreates a new conversation in Intercom. Approval by default
- WriteCreate data attributeCreate a custom data attribute for contacts or companies. Approval by default
- WriteCreate data eventSubmit a data event to Intercom to track user activities. Approval by default
- WriteCreate external pageCreate an external page in Fin Content Library or update an existing page by external ID. Approval by default
- WriteCreate help center sectionCreate a new help center section within a collection. Approval by default
- WriteCreate internal articleCreate a new internal article for team knowledge sharing. Approval by default
- WriteCreate or update a companyYou can create or update a company. Approval by default
- WriteCreate or update tagCreate or update a tag, and optionally tag/untag companies or tag contacts. Approval by default
- WriteCreate ticketCreate a ticket in Intercom to track customer requests and issues. Approval by default
- WriteCreate a ticket typeCreate a new ticket type that defines the data structure for tracking customer requests. Approval by default
- WriteCreate ticket type attributeCreate a new attribute for a ticket type in Intercom. Approval by default
- WriteCreate event summariesCreate event summaries for a user to track event occurrences. Approval by default
- WriteDelete a collectionYou can delete a single collection by making a DELETE request to `https://api.intercom.io/collections/<id>`. Approval by default
- WriteDelete a companyYou can delete a single company. Approval by default
- WriteDelete an articleYou can delete a single article by making a DELETE request to `https://api.intercom.io/articles/<id>`. Approval by default
- WriteDelete a tagDelete a tag from Intercom workspace. Approval by default
- WriteDelete a visitorDelete a visitor from the Intercom workspace. Approval by default
- WriteDelete a contactDelete a contact from the Intercom workspace. Approval by default
- WriteDelete content import sourceDelete a content import source and all its external pages. Approval by default
- WriteDelete external pageDelete an external page from content library and AI answers. Approval by default
- WriteDelete internal articleDelete a single internal article by ID. Approval by default
- WriteDelete ticketDelete a ticket from the Intercom system. Approval by default
- WriteDetach a contact from tagRemove a tag from a specific contact in Intercom. Approval by default
- WriteDetach contact from companyDetach a contact from a company in Intercom. Approval by default
- WriteDetach tag from conversationRemove a tag from a specific conversation in Intercom. Approval by default
- WriteDetach tag from ticketRemove a tag from a ticket in Intercom. Approval by default
- WriteEnqueue create ticketEnqueue ticket creation for asynchronous processing. Approval by default
- WriteMerge a lead and a userYou can merge a contact with a `role` of `lead` into a contact with a `role` of `user`. Approval by default
- WriteRegister Fin Voice callRegister a Fin Voice call with Intercom. Approval by default
- WriteRemove subscription from a contactYou can remove a specific subscription from a contact. Approval by default
- WriteRemove tag from a contactYou can remove tag from a specific contact. Approval by default
- WriteReopen conversationReopens a closed conversation in Intercom. Approval by default
- WriteReply to ticketReply to a ticket with a message from admin or contact, or with a note for admins. Approval by default
- WriteReply to conversationSends a reply to an existing conversation in Intercom. Approval by default
- WriteSet admin to awaySet an admin to away status in Intercom. Approval by default
- WriteSet an admin to awayYou can set an Admin as away for the Inbox. Approval by default
- WriteUnarchive contactUnarchive a previously archived contact in Intercom. Approval by default
- WriteUpdate a collectionYou can update the details of a single collection by making a PUT request to `https://api.intercom.io/collections/<id>`. Approval by default
- WriteUpdate a companyYou can update a single company using the Intercom provisioned `id`. Approval by default
- WriteUpdate a contactYou can update an existing contact (ie. Approval by default
- WriteUpdate an articleYou can update the details of a single article by making a PUT request to `https://api.intercom.io/articles/<id>`. Approval by default
- WriteUpdate contactUpdate an existing contact in Intercom. Approval by default
- WriteUpdate content import sourceUpdate an existing content import source in Fin Content Library. Approval by default
- WriteUpdate data attributeUpdate an existing data attribute in Intercom. Approval by default
- WriteUpdate external pageUpdate an existing external page in Fin Content Library. Approval by default
- WriteUpdate internal articleUpdate an internal article with new title, body, author or owner information. Approval by default
- WriteUpdate ticketUpdate an existing ticket in Intercom. Approval by default
- WriteUpdate a ticket typeUpdate an existing ticket type in the workspace. Approval by default
- WriteUpdate ticket type attributeUpdate an existing attribute for a ticket type. Approval by default
One prompt, start to finish
What a governed Intercom run looks like inside Luumen.
Questions
How does LuumenAI connect to Intercom?
Authorize once with OAuth 2.0. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Can LuumenAI change things in Intercom on its own?
Read actions answer immediately. Anything that writes — add subscription to a contact, add tag to contact, archive contact, assign conversation, and more — is shown as a plan and requires approval by default, including the 21 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
Who gets access to the integration?
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Is there an audit trail?
Every call to Intercom — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Often connected alongside
All integrations
Put Intercom to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.