Prerequisites
- An Intercom account (any plan)
- Admin or Developer access to create/manage apps
Getting Your Credentials
Intercom uses a Personal Access Token for authentication.
- Log into Intercom
- Go to Settings (gear icon) > Integrations > Developer Hub
- Click New app (or select an existing app)
- Navigate to Authentication
- Copy the Access Token
Required Permissions
Your Intercom app needs read permissions for the data types you want to sync. In the Developer Hub, ensure the following are enabled:
| Permission | Streams |
|---|
| Read users and companies | contacts, companies |
| Read conversations | conversations, conversation_parts |
| Read admins | admins |
| Read tags | tags |
| Read and list users, teams | teams, segments |
Configuration in Landed
| Field | Value |
|---|
| Access Token | Your Intercom access token (e.g., dG9rOjEyMzQ1Njc4...) |
Available Streams
| Stream | Description | Sync Mode |
|---|
contacts | Contact records (users and leads) with email, phone, location, custom attributes | Incremental |
companies | Company records with name, industry, size, monthly spend | Incremental |
conversations | Conversation threads with subject, state, assignee | Incremental |
conversation_parts | Individual messages within conversations | Incremental |
admins | Admin/teammate records | Full refresh |
tags | Tags used to categorize contacts and conversations | Full refresh |
teams | Teams configured in Intercom | Full refresh |
segments | Contact segments | Full refresh |
activity_logs | Admin activity audit log | Incremental |
Common Issues
| Symptom | Cause | Fix |
|---|
401 Unauthorized | Invalid or expired access token | Generate a new token in the Developer Hub |
403 Forbidden | App missing required permissions | Edit app permissions in Developer Hub > Authentication |
Rate limit exceeded | Too many API calls | Landed handles rate limiting automatically |
| Missing contacts | Token scoped to subset of data | Ensure the app has access to all workspaces |
Static IPs for Allowlisting
If your Intercom configuration requires IP allowlisting:
- Production:
34.170.185.84, 35.192.90.94
- Staging:
34.171.93.34