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`	Create a new conversation with a user or lead
GET	`/conversations/{id}`	Retrieve a specific conversation by ID
GET	`/conversations`	List all conversations with pagination and filtering
POST	`/conversations/{id}/reply`	Reply to a conversation as an admin
POST	`/conversations/{id}/parts`	Add a note, assignment, or state change to a conversation
POST	`/messages`	Send a message to a user or group of users
GET	`/contacts`	List all contacts with filtering and search capabilities
POST	`/contacts`	Create or update a contact with custom attributes
GET	`/contacts/{id}`	Retrieve a specific contact by ID
DELETE	`/contacts/{id}`	Delete a contact permanently
GET	`/admins`	List all admins and team members
GET	`/tags`	List all tags used in the workspace
POST	`/tags`	Create a new tag for organizing conversations and contacts
POST	`/events`	Track custom user events and activities
GET	`/articles`	List all help center articles

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)

Connect Intercom Messaging API to AI

Deploy a Intercom Messaging API MCP server on IOX Cloud and connect it to Claude, ChatGPT, Cursor, or any AI client. Your AI assistant gets direct access to Intercom Messaging API through these tools:

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

Deploy in 60 seconds

Describe what you need, AI generates the code, and IOX deploys it globally.

Deploy Intercom Messaging API MCP Server →

Intercom Messaging API REST API

API Endpoints

Code Examples

Connect Intercom Messaging API to AI

Deploy in 60 seconds

Related APIs