Intercom integration
Customer messaging platform API for sales, marketing, and support. Manage contacts, conversations, companies, send messages, create notes, and handle customer communications. Perfect for building customer support tools, messaging integrations, contact management systems, and customer engagement platforms.
Common Intercom use cases
- Analytics
- Data cleanup
- Team management
- Contact segmentation
- Help center management
- B2B analysis
- Data export
- Admin lookup
- Segmentation
- Company lookup
What you can do with Intercom
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Conversation, 15 operations
- POSTassign_conversation
Assigns an Intercom conversation to a team member or team. Routes support tickets for handling.
- POSTclose_conversation
Closes an Intercom conversation. Marks support thread as resolved with optional closing message.
- POSTconvert_conversation_to_ticket
Converts a conversation to a ticket.
- POSTcreate_conversation
Creates a new Intercom conversation from a user. Initiates a support thread with an initial message.
- GETget_conversation
Retrieves a specific Intercom conversation with all message parts. Returns complete thread history and participant details.
- GETlist_conversations
Lists all Intercom conversations with pagination. Returns conversation threads for inbox management and support queue viewing.
- POSTopen_conversation
Reopens a closed or snoozed conversation.
- POSTredact_conversation
Redacts sensitive content from a conversation.
- POSTreply_to_conversation
Adds a reply to an Intercom conversation. Send admin or user responses to existing threads.
- POSTrun_assignment_rules
Runs assignment rules on a conversation.
- POSTsearch_conversations
Searches conversations with advanced filter criteria.
- POSTsnooze_conversation
Snoozes a conversation to auto-reopen at a future time.
- POSTtag_conversation
Adds a tag to a conversation.
- DELETEuntag_conversation
Removes a tag from a conversation.
- PUTupdate_conversation
Updates a conversation's read status or custom attributes.
Contact, 14 operations
- POSTarchive_contact
Archives a contact to hide from active lists while preserving data.
- POSTattach_contact_to_company
Attaches a contact to a company.
- POSTcreate_contact
Creates a new contact in Intercom as user or lead. Set profile information and custom attributes during creation.
- DELETEdelete_contact
Permanently deletes a contact from Intercom. Removes user or lead and associated conversation history.
- DELETEdetach_contact_from_company
Detaches a contact from a company.
- GETget_contact
Retrieves a specific Intercom contact by ID. Returns complete profile with email, name, custom attributes, and activity data.
- GETlist_company_contacts
Lists all contacts belonging to a company.
- GETlist_contacts
Lists all Intercom contacts with cursor-based pagination.
- POSTmerge_contacts
Merges a lead into a user contact, combining their data.
- POSTsearch_contacts
Searches contacts with advanced filter criteria and sorting.
- POSTtag_contact
Applies a tag to a contact for categorization and filtering.
- POSTunarchive_contact
Restores an archived contact to active status.
- DELETEuntag_contact
Removes a tag from a contact for updated categorization.
- PUTupdate_contact
Updates an existing Intercom contact's profile. Modify name, email, phone, and custom attributes.
Company, 10 operations
- POSTcreate_company
Creates or updates a company in Intercom. Upserts organization profile with business attributes.
- DELETEdelete_company
Permanently deletes a company.
- GETget_company
Retrieves a company profile by ID.
- POSTlist_companies
Lists all companies in Intercom. Returns organization profiles for B2B customer management and account views.
- GETlist_contact_companies
Lists all companies a contact belongs to.
- GETretrieve_companies
Retrieves companies by name, company_id, tag, or segment filter.
- GETscroll_companies
Scrolls through all companies efficiently for large datasets.
- POSTtag_company
Tags one or more companies.
- POSTuntag_company
Removes a tag from companies.
- PUTupdate_company
Updates a company's profile attributes.
Article, 6 operations
- POSTcreate_article
Creates a new help center article.
- DELETEdelete_article
Permanently deletes a help center article.
- GETget_article
Retrieves a help center article by ID.
- GETlist_articles
Lists all help center articles for knowledge base management.
- GETsearch_articles
Searches help center articles by keyword or state.
- PUTupdate_article
Updates a help center article.
Tag, 5 operations
- POSTcreate_tag
Creates a new tag for contact and conversation organization.
- DELETEdelete_tag
Permanently deletes a tag.
- GETget_tag
Retrieves a tag by its ID.
- GETlist_contact_tags
Lists all tags attached to a contact.
- GETlist_tags
Lists all tags in Intercom for organizing contacts and conversations.
Ticket, 5 operations
- POSTcreate_ticket
Creates a new support ticket.
- GETget_ticket
Retrieves a ticket by ID.
- POSTreply_to_ticket
Adds a reply to a ticket.
- POSTsearch_tickets
Searches tickets with filter criteria.
- PUTupdate_ticket
Updates a ticket's attributes, state, or assignment.
Admin, 4 operations
- GETget_admin
Retrieves an admin by ID.
- GETidentify_admin
Returns the currently authenticated admin.
- GETlist_admins
Lists all admin accounts in the workspace.
- PUTset_admin_away
Sets an admin's away mode status.
Segment, 4 operations
- GETget_segment
Retrieves a segment by its ID.
- GETlist_company_segments
Lists all segments a company is part of.
- GETlist_contact_segments
Lists all segments a contact is part of.
- GETlist_segments
Lists all customer segments in Intercom.
Data attribute, 3 operations
- POSTcreate_data_attribute
Creates a new custom data attribute.
- GETlist_data_attributes
Lists all data attributes in the workspace.
- PUTupdate_data_attribute
Updates a custom data attribute.
Event, 3 operations
- POSTcreate_event_summaries
Creates event summaries for segmentation and reporting.
- GETlist_events
Lists events for a user (up to 90 days old).
- POSTsubmit_event
Submits a data event to track user actions.
Note, 3 operations
- POSTcreate_note
Creates an internal note on an Intercom contact. Add private annotations visible only to team members.
- GETget_note
Retrieves a note by its ID.
- GETlist_contact_notes
Lists all internal notes on a contact.
Subscription type, 2 operations
- GETlist_contact_subscriptions
Lists subscriptions for a contact.
- GETlist_subscription_types
Lists all email subscription types.
Team, 2 operations
- GETget_team
Retrieves a team and its members.
- GETlist_teams
Lists all teams in the workspace.
Activity log, 1 operation
- GETlist_activity_logs
Lists admin activity logs for audit purposes.
Collection, 1 operation
- GETlist_collections
Lists all help center collections.
Message, 1 operation
- POSTsend_message
Sends a message to an Intercom user. Deliver in-app messages or emails for outreach and engagement.
Ticket type, 1 operation
- GETlist_ticket_types
Lists all ticket types.
Intercom API rate limits
- 10,000 requests per minute
10,000 req/min per app, 25,000 req/min per workspace. See https://developers.intercom.com/docs/references/rest-api/errors/rate-limiting
These are the limits Intercom documents, not ones LiveContext measured. They can change and often depend on your plan, so check the Intercom documentation for current values.
Use Intercom from Claude Code, Cursor or Codex
Connect Intercom in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Intercom operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Intercom
Create your workspace
Sign up free. Nothing to install.
Connect Intercom once
Add your Intercom connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Intercom integration FAQ
- What can you do with the Intercom integration?
- LiveContext exposes 80 operations on Intercom, covering conversation, contact, company and article. Common uses include Analytics, Data cleanup and Team management.
- What are the Intercom API rate limits?
- Intercom documents 10,000 requests per minute. 10,000 req/min per app, 25,000 req/min per workspace. See https://developers.intercom.com/docs/references/rest-api/errors/rate-limiting Limits are set by Intercom and can depend on your plan.
Popular integrations
Instagram API with Instagram Login (graph.instagram.com). Manage a Business/Creator Instagram account…
Messaging platform API for building bots and integrations. Send messages, manage chats and channels, handle…
Google's video platform API for accessing video, channel, playlist, and comment data
Social media platform API for content creators and businesses. Access user info, manage videos, get…
Social media platform API for posting, reading, and managing Twitter/X content. Post tweets, read timelines,…
Google email service API for sending, receiving, and managing emails. Access messages, threads, labels,…
AI API from xAI (Elon Musk's AI company) powering Grok models. Access state-of-the-art language models with…
Professional networking platform API for managing profiles, connections, and content. Share posts, manage…