Intercom

LiveAPI Key

Communication

Identify companies visiting your site and enrich Intercom with company data for better live chat experiences. When ClearView identifies a visiting company, it creates or updates the company and contact in Intercom, giving your support and sales team instant context about who they are chatting with.

What Gets Synced

Intercom companies

Created or updated with name, domain, and industry

Contact records

Contacts linked to their company with email and role

Custom attributes

Lead score, page views, and ClearView source tag

Company tags

Industry and lead classification tags

Supported Events

Event	Trigger	Action
`company.identified`	A new company is identified visiting your site	Create or update company and contact in Intercom

Prerequisites

An Intercom account with a workspace
Admin access to create access tokens
An Intercom access token with read/write permissions for contacts and companies
ClearView tracking script installed on your site

Setup Guide

Log in to Intercom

Go to app.intercom.com and sign in with your admin credentials.

Navigate to Developer settings

Click on the gear icon to open Settings, then select Developers from the left sidebar. If you do not see it, you may need to click on Integrations > Developer Hub.

Path: Settings > Developers > Access Tokens

Create an access token

Click on "New token" or navigate to an existing app and generate an access token. Ensure the token has read and write permissions for Contacts and Companies. Copy the access token.

Token permissions

The access token must have write access to both Contacts and Companies in Intercom. Without these permissions, ClearView will not be able to create or update records.

Configure in ClearView

In your ClearView dashboard, go to Settings > Integrations. Find Intercom and click Connect. Paste your access token.

Required Fields

Access TokendG9rOmxxxxxxxxxxxxxxxx

Test the connection

Click the "Test" button to verify your credentials. ClearView will attempt to authenticate with Intercom and confirm the integration is active.

Data Mapping

ClearView Field	Intercom Field	Example
Company name	`company.name`	Acme Corp
Domain	`company.website`	acmecorp.com
Industry	`company.industry`	SaaS
Company email	`contact.email`	info@acmecorp.com
Lead score	Custom attribute `clearview_lead_score`	85

Example Output

When a company is identified, ClearView creates or updates both a company and contact in Intercom:

Intercom Company + Contact

json

// Company created/updated in Intercom:
{
  "type": "company",
  "company_id": "acmecorp-com",
  "name": "Acme Corp",
  "website": "acmecorp.com",
  "industry": "SaaS",
  "custom_attributes": {
    "clearview_lead_score": 85,
    "clearview_source": true,
    "first_seen": "2025-01-15T10:30:00Z"
  },
  "tags": ["hot-lead", "clearview"]
}
// Contact linked to company:
{
  "type": "contact",
  "role": "lead",
  "email": "info@acmecorp.com",
  "name": "Acme Corp",
  "company": { "company_id": "acmecorp-com" },
  "custom_attributes": {
    "clearview_lead_score": 85,
    "page_views": 12
  }
}

Troubleshooting

"Unauthorized" error

Your access token may be invalid or expired. Go to Settings > Developers in Intercom and generate a new token. Make sure the token has read and write access for Contacts and Companies.

Companies not appearing in Intercom

Verify your ClearView tracking script is installed and identifying companies. Check the ClearView dashboard for recent identifications. Also confirm the access token has Company write permissions.

Duplicate contacts

ClearView uses the company email as the unique identifier. If you see duplicates, it may be because the same company has multiple email addresses. ClearView will always use the primary domain email (info@domain.com).

Need help?

If you are having trouble setting up the Intercom integration, our team is here to help.

Contact Support|Back to Docs