Customer Communication Bearer Token

Intercom Messaging API REST API

Customer messaging and engagement platform API

The Intercom Messaging API enables developers to build powerful customer communication workflows, manage conversations, and automate messaging across web, mobile, and social channels. It provides programmatic access to conversations, contacts, messages, and automation features that help businesses deliver personalized customer experiences at scale.

Base URL https://api.intercom.io

API Endpoints

Method	Endpoint	Description
POST	`/conversations`	Creates a new conversation with a user or lead, returning the conversation ID and initial state.
GET	`/conversations/{id}`	Retrieves a specific conversation by ID, including all parts, participants, and current assignment.
GET	`/conversations`	List all conversations with pagination and filtering
POST	`/conversations/{id}/reply`	Posts an admin reply to the conversation identified by {id}, appending it to the conversation parts.
POST	`/conversations/{id}/parts`	Add a note, assignment, or state change to a conversation
POST	`/messages`	Sends a message to a user or user segment, supporting in-app and email delivery methods.
GET	`/contacts`	List all contacts with filtering and search capabilities
POST	`/contacts`	Create or update a contact with custom attributes
GET	`/contacts/{id}`	Retrieves a specific contact by ID, including role, custom attributes, and associated companies.
DELETE	`/contacts/{id}`	Permanently deletes the contact identified by {id} and removes all associated data.
GET	`/admins`	Lists all admins and team members with their roles, names, and email addresses.
GET	`/tags`	Lists all tags used in the workspace, returning tag IDs and names for filtering.
POST	`/tags`	Create a new tag for organizing conversations and contacts
POST	`/events`	Tracks custom user events and activities, requiring user_id and event_name in the request body.
GET	`/articles`	Lists all help center articles with titles, IDs, and publication status for content retrieval.

Code Examples

curl https://api.intercom.io/conversations \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Intercom-Version: 2.10'

const response = await fetch('https://api.intercom.io/conversations', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Accept': 'application/json',
    'Intercom-Version': '2.10'
  }
});
const conversations = await response.json();
console.log(conversations);

import requests

url = 'https://api.intercom.io/conversations'
headers = {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Accept': 'application/json',
    'Intercom-Version': '2.10'
}

response = requests.get(url, headers=headers)
conversations = response.json()
print(conversations)

Use Intercom Messaging API from Claude / Cursor / ChatGPT

Get a hosted MCP endpoint for Intercom Messaging API. Paste your Intercom Messaging API API key, copy back one URL, drop it into Claude Desktop, Cursor, or any AI client that supports remote MCP. Your AI calls Intercom Messaging API directly with your credentials — no local install, works on mobile.

send_intercom_message Send targeted messages to users or user segments based on AI-identified triggers or customer behavior patterns

search_conversations Search and retrieve conversations using natural language queries to find relevant customer interactions and sentiment

update_contact_attributes Automatically update contact profiles with enriched data, tags, or custom attributes based on conversation analysis

manage_conversation_workflow Assign conversations to appropriate teams, add notes, or change conversation states based on AI classification

track_user_events Log custom events and user activities to build comprehensive customer journey timelines for personalization

Connect in 60 seconds

Paste your Intercom Messaging API key → get an MCP URL → paste into Claude/Cursor. Hosted by IOX, encrypted at rest.

Connect Intercom Messaging API to your AI →

Intercom Messaging API REST API

API Endpoints

Sponsor this page

Code Examples

Use Intercom Messaging API from Claude / Cursor / ChatGPT

Connect in 60 seconds

Related APIs