Intercom website screenshot

Intercom

Intercom is an AI-powered customer service platform that enables businesses to build seamless customized experiences through its Help Desk and Messenger. The Intercom API allows developers to integrate with the Intercom platform using RESTful APIs and SDKs.

Intercom publishes 1 API on the APIs.io network. Tagged areas include AI, Customer Service, Customer Support, and Messaging.

The Intercom catalog on APIs.io includes 1 event-driven AsyncAPI specification and 2 Spectral governance rulesets.

Intercom’s developer surface includes authentication, developer portal, engineering blog, documentation, support, signup flow, and 7 more developer resources.

46.2/100 developing ▬ flat Agent 54/100 agent ready Full breakdown ↓
scored 2026-07-21 · rubric v0.4
1 APIs 16 Features
AICustomer ServiceCustomer SupportMessaging

API Rating

API Evangelist API Evangelist Rating How this is scored →
scored 2026-07-21 · rubric v0.4
Composite quality — 46.2/100 · developing
Contract Quality 15.5 / 25
Developer Ergonomics 7.0 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 4.8 / 13
Governance 6.3 / 12
Discoverability 4.8 / 10
Agent readiness — 54/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 15
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/intercom: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs

Intercom API

The Intercom API provides programmatic access to the Intercom customer service platform. Build apps on the complete AI customer service platform and create seamless customized e...

Collections

GraphQL

Intercom GraphQL

Intercom does not publish a public GraphQL API. Its developer platform is built entirely on REST. The GraphQL schema in this directory is a conceptual data model derived from th...

GRAPHQL

Pricing Plans

Intercom Plans Pricing

4 plans

PLANS

Rate Limits

Intercom Rate Limits

3 limits

RATE LIMITS

FinOps

Features

Essential at $29/seat/mo with Fin Customer Agent and Messenger
Advanced at $85/seat/mo with workflows automation and 20 free Lite seats
Expert at $132/seat/mo with SSO, HIPAA, SLAs, multibrand
Fin AI Agent standalone at $0.99 per resolved outcome
Pro AI add-on at $99/mo (CX Score, Topics, Custom Scorecards)
Copilot AI add-on at $29/agent/mo
Proactive Support Plus add-on at $99/mo
REST API at ~166 req/10s (1000/min) standard, 33/10s search, 16/10s bulk
Conversations, Contacts, Companies, Tickets, Articles APIs
Webhooks for real-time event delivery
Outbound messaging via Posts, Surveys, Tours
SMS and WhatsApp campaigns (usage-based)
Phone Plus voice support (usage-based)
Knowledge base and AI-powered help center
OAuth 2.0 and personal access tokens
Apps Framework for marketplace and embedded apps

Event Specifications

Intercom Webhooks

AsyncAPI description of Intercom's outbound webhook surface. Intercom delivers workspace events to a single subscriber URL configured per app under the Developer Hub > Webhooks ...

ASYNCAPI

API Governance Rules

Intercom API Rules

8 rules · 1 errors 7 warnings

SPECTRAL

Intercom API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Structure

Intercom Structure

0 properties

JSON STRUCTURE

Resources

Get Started 2

Portal, sign-up, and the first successful call

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

Build 1

SDKs, sample code, and the tooling you integrate with

Access & Security 3

Authentication, authorization, and security posture

Operate 1

Status, limits, changes, and where to get help

Company 3

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
opencollection: 1.0.0
info:
  name: Intercom API
  version: '2.15'
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: Admins
    type: folder
  items:
  - info:
      name: Identify an admin
      type: http
    http:
      method: GET
      url: https://api.intercom.io/me
    docs: Returns information about the admin user authenticated by the access token used in the request.
  - info:
      name: List admins
      type: http
    http:
      method: GET
      url: https://api.intercom.io/admins
    docs: Retrieves a paginated list of admins in your Intercom workspace.
- info:
    name: Contacts
    type: folder
  items:
  - info:
      name: List contacts
      type: http
    http:
      method: GET
      url: https://api.intercom.io/contacts
      params:
      - name: per_page
        value: ''
        type: query
      - name: starting_after
        value: ''
        type: query
    docs: Retrieves a paginated list of contacts.
  - info:
      name: Create a contact
      type: http
    http:
      method: POST
      url: https://api.intercom.io/contacts
      body:
        type: json
        data: '{}'
    docs: Creates a new contact (user or lead) in your Intercom workspace.
  - info:
      name: Retrieve a contact
      type: http
    http:
      method: GET
      url: https://api.intercom.io/contacts/:contact_id
      params:
      - name: contact_id
        value: ''
        type: path
    docs: Retrieves a single contact by ID.
- info:
    name: Companies
    type: folder
  items:
  - info:
      name: List companies
      type: http
    http:
      method: GET
      url: https://api.intercom.io/companies
    docs: Retrieves a paginated list of companies.
  - info:
      name: Create or update a company
      type: http
    http:
      method: POST
      url: https://api.intercom.io/companies
      body:
        type: json
        data: '{}'
    docs: Creates or updates a company record by company_id.
- info:
    name: Conversations
    type: folder
  items:
  - info:
      name: List conversations
      type: http
    http:
      method: GET
      url: https://api.intercom.io/conversations
    docs: Retrieves a paginated list of conversations.
  - info:
      name: Create a conversation
      type: http
    http:
      method: POST
      url: https://api.intercom.io/conversations
      body:
        type: json
        data: '{}'
    docs: Creates a new user-initiated conversation.
  - info:
      name: Retrieve a conversation
      type: http
    http:
      method: GET
      url: https://api.intercom.io/conversations/:conversation_id
      params:
      - name: conversation_id
        value: ''
        type: path
    docs: Retrieve a conversation
- info:
    name: Articles
    type: folder
  items:
  - info:
      name: List articles
      type: http
    http:
      method: GET
      url: https://api.intercom.io/articles
    docs: List articles
  - info:
      name: Create an article
      type: http
    http:
      method: POST
      url: https://api.intercom.io/articles
      body:
        type: json
        data: '{}'
    docs: Create an article
- info:
    name: Segments
    type: folder
  items:
  - info:
      name: List segments
      type: http
    http:
      method: GET
      url: https://api.intercom.io/segments
    docs: List segments
- info:
    name: Messages
    type: folder
  items:
  - info:
      name: Create a message
      type: http
    http:
      method: POST
      url: https://api.intercom.io/messages
      body:
        type: json
        data: '{}'
    docs: Sends an outbound message to a contact.
- info:
    name: Data Events
    type: folder
  items:
  - info:
      name: List data events
      type: http
    http:
      method: GET
      url: https://api.intercom.io/events
      params:
      - name: type
        value: ''
        type: query
      - name: user_id
        value: ''
        type: query
    docs: List data events
  - info:
      name: Submit a data event
      type: http
    http:
      method: POST
      url: https://api.intercom.io/events
      body:
        type: json
        data: '{}'
    docs: Submits a custom data event tracking user activity.
- info:
    name: News
    type: folder
  items:
  - info:
      name: List news items
      type: http
    http:
      method: GET
      url: https://api.intercom.io/news/news_items
    docs: List news items
  - info:
      name: Create a news item
      type: http
    http:
      method: POST
      url: https://api.intercom.io/news/news_items
      body:
        type: json
        data: '{}'
    docs: Create a news item
bundled: true