Intercom
Sync data from your warehouse to Intercom. Keep your Intercom Contacts and Companies enriched with the latest customer attributes.
Prerequisites
- An Intercom account
- An Intercom access token or OAuth connection
Authentication
Intercom supports two authentication methods:
Access Token
- In Intercom, go to Settings > Integrations > Developer Hub
- Create a new app or select an existing one
- Copy the Access Token
- Paste it into the Access Token field in SignalSmith
OAuth 2.0
- Click Connect with OAuth in SignalSmith
- Sign in to your Intercom account
- Authorize the requested permissions
Configuration
Intercom does not require any additional configuration fields beyond authentication.
Target Settings
| Field | Type | Required | Description |
|---|---|---|---|
| Object Type | Select | Yes | The Intercom object to sync to: Contacts or Companies |
Supported Operations
Sync Modes
| Mode | Supported |
|---|---|
| Upsert | Yes |
| Insert | Yes |
| Update | Yes |
| Mirror | — |
Audience Sync Modes
| Mode | Supported |
|---|---|
| Add | Yes |
| Remove | Yes |
| Mirror | Yes |
| Upsert | Yes |
Features
- Field Mapping: Yes
- Schema Introspection: No
Required Mapping Fields
| Object | Required Fields |
|---|---|
| Contacts | |
| Companies | company_id |
Default Destination Fields
Contacts: email, name, phone, role, external_id
Companies: company_id, name, plan, monthly_spend
Troubleshooting
Authentication failed: invalid or expired token
Generate a new access token in the Intercom Developer Hub, or reconnect via OAuth.
Contact not found for update
When using Update mode, the contact must already exist in Intercom. Use Upsert mode to create contacts that do not exist.
Rate limiting
Intercom enforces API rate limits. SignalSmith handles rate limiting with automatic retries and backoff.
Custom attributes not syncing
Custom attributes must be created in Intercom before they can be synced. Go to Settings > People data > Custom attributes to create them.