Helpdesk migration
Field-level mapping, validation, and rollback between Help Scout and Intercom. We move data and schema; workflows are rebuilt natively in Intercom.
Help Scout
Source
Intercom
Destination
Compatibility
7 of 10
objects map 1:1 between Help Scout and Intercom.
Complexity
CModerate
Timeline
1-3 weeks
Overview
Moving from Help Scout to Intercom is a structural migration that restructures the core conversation object and introduces Intercom's per-seat pricing model. Help Scout Conversations map to Intercom Tickets, but Help Scout's three-state status model (Open, Pending, Closed) requires a mapping decision because Intercom natively supports only Open and Closed. We preserve the Pending state as a custom Ticket attribute or Status label so no conversation loses its waiting-for-customer context. Customer records (Help Scout Customers) map to Intercom Contacts and optionally Companies based on the customer's organizational hierarchy. Docs knowledge base (Collections, Sub-collections, Articles) migrates as Intercom Sections and Articles with navigation structure preserved. Help Scout Workflows, Custom Fields gated to Plus plan tiers, and reporting data that requires API access do not migrate; we deliver a written inventory of every active Workflow and a manual reporting export guide for the customer to act on post-migration.
Every standard and custom field arrives verified.
AI proposes the map; you confirm before any record moves.
Parent–child, lookups, and ownership stay linked.
Calls, emails, meetings — with original timestamps.
Documents, uploads, and inline notes move with the record.
Why teams make this switch
Leaving
What's pushing teams away
Choosing
What's pulling them in
Object mapping
Each row shows how a Help Scout object lands in Intercom, including any object-level transformations, lookup resolution, or schema-design dependencies.
Typical mapping — final map is confirmed during the sample migration step.
Help Scout
Conversation
Intercom
Ticket
1:1Help Scout Conversations map to Intercom Tickets as the primary conversation container. The Help Scout Open and Closed statuses map directly to Intercom Open and Closed. Help Scout's Pending status has no native Intercom equivalent; we create a custom Ticket attribute (such as a status label or tag) to preserve the Pending context so teams do not lose the waiting-for-customer signal. Thread history, public replies, and attachment references transfer as Ticket conversation parts. We resolve the owner (agent) by email match against Intercom Admins.
Help Scout
Customer
Intercom
Contact
1:1Help Scout Customer records (email, name, phone, address, company association) map directly to Intercom Contacts. The Help Scout Customer Properties custom fields (if the source account is on Plus tier) map to Intercom custom attributes on the Contact. We resolve the company reference from Help Scout Customers to an Intercom Company record, creating the Company first if it does not exist before Contact import so the lookup relationship is satisfied at insert time.
Help Scout
Mailbox
Intercom
Inbox or Team
lossyHelp Scout Mailboxes (shared inbox containers, up to 10 per account on Standard, unlimited on Plus/Pro) map to Intercom Inboxes. If the source account uses Help Scout Teams and Departments for routing, we map those to Intercom Teams for inbox assignment. Routing rules that send conversations from specific mailboxes to specific agents or teams become Intercom assignment rules and inbox routing. Help Scout Mailbox-level Custom Fields (up to 10 per mailbox, Plus/Pro only) are preserved as Intercom Ticket attributes scoped to that inbox's tickets.
Help Scout
Docs (Knowledge Base)
Intercom
Help Center (Articles)
1:1Help Scout Docs articles organized within Collections and Sub-collections map to Intercom Help Center Sections and Articles. Help Scout Collections map to Intercom Sections; Sub-collections map to Articles within a Section, or we create nested sections if the destination plan supports hierarchy. Published status, article body content, author attribution, and visible/hidden state transfer. If the Help Scout Docs has multi-language articles (translations stored in separate Collections), we create Intercom Help Center translations per article, noting that Intercom supports article-level translations but not a separate translation object structure.
Help Scout
Tag
Intercom
Tag
lossyHelp Scout Tags applied to Conversations transfer as Intercom Tags on Tickets. Help Scout Tags applied to Docs transfer as Intercom Tags on Articles. Tags applied to Customers do not have a native equivalent in Intercom Contacts because Intercom does not tag Contacts; we either create Intercom Contact Segments as a replacement or map the tag to a Contact custom attribute. The tag strategy for Customer tags is decided during scoping based on how the customer uses tagging in Help Scout.
Help Scout
Custom Fields
Intercom
Custom Attributes
1:1Help Scout Custom Fields (Dropdown, Single line, Multi line, Number, Date) are gated to the Plus plan and exist at the Mailbox level (up to 10 per mailbox). We map them to Intercom Contact custom attributes or Ticket custom attributes depending on whether the field is a Customer Property or a Mailbox-level field. If the source account is on Free or Standard tier (no Custom Fields), this mapping is skipped. Dropdown fields with up to 100 options map to Intercom select attributes; number and date fields map to the equivalent Intercom types.
Help Scout
Customer Properties
Intercom
Contact Custom Attributes
1:1Help Scout Customer Properties are custom fields set specifically at the Customer record level. These map to Intercom Contact custom attributes. The field type (text, number, dropdown, date) is preserved. We detect the Plus-tier requirement during scoping; if the source is on Standard, Customer Properties exist as standard Help Scout properties and map to Intercom standard Contact fields (phone, address, company) where possible, with remaining data in custom attributes.
Help Scout
User (Agent)
Intercom
Admin or Agent
1:1Help Scout Users (agents and team members) map to Intercom Admins and Agents. Help Scout role assignments (Admin, Member, Collaborator) map to Intercom's permission levels. We match by email address and preserve the role. Help Scout's unlimited-user model means the user count during migration has no billing constraint in Help Scout; in Intercom, each mapped user counts toward the per-seat license count, which is a cost impact we flag during scoping.
Help Scout
Workflows (Automations)
Intercom
(Documented for rebuild)
lossyHelp Scout Automatic Workflows (triggered by conversation status, mailbox assignment, or customer properties) do not migrate to Intercom as code because Intercom uses a different automation model (Rules engine, not visual workflow builder with the same trigger-action vocabulary). We deliver a written inventory of every active Help Scout Workflow with its trigger, conditions, and actions mapped to a recommended Intercom Rule equivalent. The customer rebuilds automations in Intercom's Rules engine post-migration. Workflows with complex nested conditions or multiple triggers are flagged as higher-effort rebuild items.
Help Scout
Attachment
Intercom
File Attachment
1:1Attachments embedded in Help Scout conversation threads (images, PDFs, documents) are exported as binary blobs via the Inbox API and re-attached to the corresponding Intercom conversation parts. We note that Intercom restricts certain file types (.exe, .sys, .scr, .wsf, and others) for security reasons; if the source attachments include any restricted types, we flag them during scoping and recommend the customer whitelist specific file extensions in Intercom Settings before migration begins.
| Help Scout | Intercom | Compatibility | |
|---|---|---|---|
| Conversation | Ticket1:1 | Fully supported | |
| Customer | Contact1:1 | Fully supported | |
| Mailbox | Inbox or Teamlossy | Fully supported | |
| Docs (Knowledge Base) | Help Center (Articles)1:1 | Fully supported | |
| Tag | Taglossy | Fully supported | |
| Custom Fields | Custom Attributes1:1 | Mapping required | |
| Customer Properties | Contact Custom Attributes1:1 | Mapping required | |
| User (Agent) | Admin or Agent1:1 | Fully supported | |
| Workflows (Automations) | (Documented for rebuild)lossy | Mapping required | |
| Attachment | File Attachment1:1 | Fully supported |
Gotchas + challenges
Platform-specific issues from each side, plus the pair-specific challenges that don't show up on either platform's page on its own.
Help Scout gotchas
Contact billing cap causes migration bill shock
Per-account API rate limit throttles bulk migration
Custom Fields locked behind Plus plan
Reporting data not accessible via API
Docs knowledge base is separately priced
Intercom gotchas
S3 JSON export omits conversation transcripts
Workspace isolation prevents workflow migration
Fin AI resolution fees compound with automation success
Two-year conversation history limit on historical export
Private app rate limits share workspace quota
Pair-specific challenges
Migration approach
Discovery and plan tier audit
We audit the Help Scout account across plan tier (Free, Standard, Plus, Pro), mailbox count, conversation volume, active Workflow count, Docs article count and hierarchy depth, Custom Field presence, and attachment volume. We confirm whether the source account is on Plus or Pro because Custom Fields and additional Mailboxes affect mapping scope. We also request a manual CSV export of Help Scout Reports data for the customer to preserve historically. The discovery output is a written migration scope that lists every object to be migrated, the estimated Intercom per-seat cost impact, and a flag for any restricted attachment file types found in the source account.
Schema mapping and Intercom configuration
We design the Intercom destination schema before any data moves. This includes provisioning Intercom Inboxes (mapped from Help Scout Mailboxes), creating Teams (from Help Scout Departments if applicable), designing the custom Ticket attributes to preserve Help Scout Pending status and any Mailbox-level Custom Fields, configuring the Help Center Sections (mapped from Docs Collections), and planning the Contact segmentation strategy for Help Scout Customer tags. We also confirm whether Intercom's file attachment settings need to be updated to allow the customer's specific attachment types. All configuration is validated in a staging Intercom workspace before production migration begins.
Help Scout data extraction
We extract Help Scout data via the Inbox API and Docs API using rate-limit-aware pacing. For conversations, we paginate through the full conversation list with thread history (public replies, internal notes, attachments). For customers, we extract all contact records including Customer Properties and company associations. For Docs, we recursively traverse Collections, Sub-collections, and Articles, preserving article body content, author, published status, and translation data. We extract Tags across all three objects and map the tag list for later reconciliation. We extract User records with role assignments for admin-agent mapping.
Transformation, deduplication, and field mapping
We apply the mapping transformations: Conversations to Tickets with Pending status preservation, Customers to Contacts with optional Company lookup, Mailboxes to Inboxes, Docs Collections to Help Center Sections with hierarchy flattening if needed, Tags to Intercom Tags, and Custom Fields to custom attributes. We deduplicate Contacts by email during transformation. For internal notes in Help Scout (which use a different visibility model from public replies), we flag them for import as internal notes in the Intercom conversation timeline using the Notes API. We generate a transformation report showing record counts per object and any fields that could not be mapped due to plan tier constraints.
Production migration and row-count reconciliation
We run the production migration into the live Intercom workspace in dependency order: Admins and Agents (matched by email), Companies (so Contact lookups resolve), Contacts (with deduplication applied), Tickets (with Pending status preserved, internal notes attached, attachment blobs uploaded), Help Center Articles (with hierarchy structure applied), and Tags (applied to the migrated objects). Each phase emits a reconciliation report showing the source count, imported count, skipped count, and error count. The customer reviews the reconciliation report and spot-checks records before we proceed to the final delta pass.
Cutover, delta sync, and Workflow rebuild handoff
We freeze Help Scout writes during the cutover window, run a delta migration of any conversations, customers, or Docs articles modified or created during the migration, then enable Intercom as the system of record. We deliver the Workflow inventory document (with Intercom Rule equivalents documented) to the customer's admin team. We support a three-day hypercare window to resolve any record linkage issues or missing data flagged by the team after go-live. We do not rebuild Help Scout Workflows as Intercom Rules within the migration scope; that is a separate configuration task or a consulting engagement.
Platform deep dives
Help Scout
Source
Strengths
Weaknesses
Intercom
Destination
Strengths
Weaknesses
Complexity grading
Moderate Helpdesk migration. 4 of 7 objects need a mapping; the rest are 1:1.
Overall complexity
Moderate migration
Derived from compatibility, mapping clarity, API constraints, and data volume across Help Scout and Intercom.
Object compatibility
4 of 7 objects need a mapping; the rest are 1:1.
Field mapping clarity
Field mapping is derived from defaults — final spec confirmed during the sample migration.
Timeline complexity
7-object category — typical timelines run 2–7 days end-to-end.
API constraints
Help Scout: Per-account limit measured per 10-minute window; exact limits vary by plan tier and are not publicly disclosed.
Data volume sensitivity
Help Scout doesn't expose a bulk API — REST + parallelization used for high-volume runs.
Estimator
Rule-based pricing — no per-record fees, no manual quotes. Migrations over 2M records are scoped individually.
Step 1
Pick a category, then your source and destination platforms.
Category
FAQ
Answers to the questions buyers ask most during Help Scout to Intercom migration scoping. Not seeing yours? Book a call.
Walk through your Help Scout to Intercom migration with a real engineer — 30 minutes, free, written quote within 24 hours.
Book a free 30 minute consultationAdjacent paths
Other ways to leave Help Scout
Other ways to arrive at Intercom
Ready when you are
Tell us record counts and timeline. We'll come back with a written quote inside 1 business day — no commitment, no sales pitch.