Intercom API

Customer messaging platform with conversations, contacts, and events APIs.

Quick Facts

Overview

Intercom API is a e-commerce & crm apis provided by Intercom. Customer messaging platform with conversations, contacts, and events APIs. This API is designed to help developers integrate ecommerce capabilities into their applications with minimal setup and maximum reliability.

The API supports Bearer Token authentication, ensuring secure access to all endpoints. With a subscription pricing model, Intercom offers flexible options for projects of any size, from prototypes to enterprise deployments.

Intercom maintains comprehensive documentation, SDKs for popular programming languages, and active community support. The API is built on REST principles, returning JSON responses with standard HTTP status codes, making it straightforward to integrate into existing workflows.

Authentication

This API uses Bearer Token authentication. Send your API key as a Bearer token in the Authorization header of each request. The format is: Authorization: Bearer YOUR_API_KEY.

Always store your credentials securely using environment variables or a secrets manager. Never commit API keys to version control or expose them in client-side code.

Code Samples

Python

import requests
import os

API_KEY = os.environ.get("API_KEY", "YOUR_API_KEY")
BASE_URL = "https://api.intercom.com"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

response = requests.get(f"{BASE_URL}/v1/resources", headers=headers)
print(response.status_code)
print(response.json())

JavaScript

const API_KEY = process.env.API_KEY || 'YOUR_API_KEY';
const BASE_URL = 'https://api.intercom.com';

const response = await fetch(`${BASE_URL}/v1/resources`, {
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  }
});
const data = await response.json();
console.log(data);

cURL

curl -H "Authorization: Bearer $API_KEY" \
     -H "Content-Type: application/json" \
     https://api.intercom.com/v1/resources

Go

package main

import (
    "net/http"
    "fmt"
    "io"
    "os"
)

func main() {
    apiKey := os.Getenv("API_KEY")
    if apiKey == "" {
        apiKey = "YOUR_API_KEY"
    }
    req, _ := http.NewRequest("GET", "https://api.intercom.com/v1/resources", nil)
    req.Header.Set("Authorization", "Bearer " + apiKey)
    req.Header.Set("Content-Type", "application/json")
    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

Pricing

The pricing model is subscription. Monthly or annual subscription with included usage and overage fees. Visit the provider’s pricing page at https://developers.intercom.com for current rates and detailed pricing information.

Use Cases

• Integration: Connect Intercom services to your application for seamless ecommerce functionality.
• Automation: Automate ecommerce workflows and reduce manual operations.
• Scaling: Handle growing ecommerce demands with Intercom’s robust infrastructure.

Related APIs

• Shopify API
• WooCommerce API
• BigCommerce API
• Magento API
• Salesforce API

Further Reading

• Integration Guide
• FAQ
• Glossary