Helpdesk migration

Migrate from Help Scout to Intercom

Field-level mapping, validation, and rollback between Help Scout and Intercom. We move data and schema; workflows are rebuilt natively in Intercom.

Help Scout logo

Help Scout

Source

Intercom

Destination

Intercom logo

Compatibility

70%

7 of 10

objects map 1:1 between Help Scout and Intercom.

Complexity

CModerate

Timeline

1-3 weeks

Rollback included Accuracy guarantee Field-level validation

Overview

What this migration involves

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.

Field-level fidelity

Every standard and custom field arrives verified.

Schema-aware mapping

AI proposes the map; you confirm before any record moves.

Relationships preserved

Parent–child, lookups, and ownership stay linked.

Full activity history

Calls, emails, meetings — with original timestamps.

Attachments & notes

Documents, uploads, and inline notes move with the record.

Why teams make this switch

Two sides of the same decision

Leaving

Help Scout logo

Help Scout

What's pushing teams away

  • Reporting and analytics are shallow compared to enterprise platforms, lacking detailed custom reports, real-time dashboards, and advanced segmentation
  • Limited customization and template flexibility frustrates teams with complex routing or branding requirements
  • Feature gaps emerge as teams scale — no ticket numbering convention, limited integrations (100+ vs Zendesk/Front), and no omnichannel depth beyond email and chat
  • Contact-based billing surprises occur when teams import historical contacts, triggering unexpected bill spikes on the contact cap
  • No VOIP or phone channel support means teams needing voice support must look elsewhere or bolt on third-party tools

Choosing

Intercom logo

Intercom

What's pulling them in

  • Instant chat and message threading on websites and apps gives support teams a single inbox without context-switching, according to reviewers on Capterra and G2 who highlight fast response times as a primary benefit.
  • Fin AI handles repetitive inbound queries automatically, reducing agent workload measurably — G2 reviewers report fewer escalations and faster first-response times once Fin is configured.
  • Automation workflows (Outbound, Operator, and custom bots) allow teams to qualify leads and route tickets without manual intervention, appealing to growth-stage SaaS companies managing high ticket volumes.
  • Help center articles and self-service deflection are natively integrated, so knowledge base content and chat conversations live in the same workspace, simplifying reporting.
  • Multi-channel support (live chat, email, SMS, WhatsApp, Phone) consolidates customer touchpoints into one inbox, reducing the operational overhead of managing separate tools.

Object mapping

How Help Scout objects map to Intercom

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

maps to

Intercom

Ticket

1:1
Fully supported

Help 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

maps to

Intercom

Contact

1:1
Fully supported

Help 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

maps to

Intercom

Inbox or Team

lossy
Fully supported

Help 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)

maps to

Intercom

Help Center (Articles)

1:1
Fully supported

Help 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

maps to

Intercom

Tag

lossy
Fully supported

Help 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

maps to

Intercom

Custom Attributes

1:1
Mapping required

Help 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

maps to

Intercom

Contact Custom Attributes

1:1
Mapping required

Help 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)

maps to

Intercom

Admin or Agent

1:1
Fully supported

Help 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)

maps to

Intercom

(Documented for rebuild)

lossy
Mapping required

Help 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

maps to

Intercom

File Attachment

1:1
Fully supported

Attachments 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.

Gotchas + challenges

What specifically takes care here

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 logo

Help Scout gotchas

High

Contact billing cap causes migration bill shock

High

Per-account API rate limit throttles bulk migration

Medium

Custom Fields locked behind Plus plan

Medium

Reporting data not accessible via API

Low

Docs knowledge base is separately priced

Intercom logo

Intercom gotchas

High

S3 JSON export omits conversation transcripts

High

Workspace isolation prevents workflow migration

Medium

Fin AI resolution fees compound with automation success

Medium

Two-year conversation history limit on historical export

Low

Private app rate limits share workspace quota

Pair-specific challenges

  • Pending status has no native Intercom equivalent

    Help Scout uses three conversation states (Open, Pending, Closed), where Pending signals that the agent is waiting for a customer reply and has set that expectation. Intercom natively supports only Open and Closed. If your team uses Pending as an active workflow state (not just a manual label), migrating it as-is will flatten the status to either Open or Closed, losing the signal that the conversation is in a waiting state. We handle this by creating a custom Ticket attribute called 'hs_waiting_for_customer' (boolean or select) on the Intercom side to preserve the Pending context for every migrated conversation. Your team decides whether to display this attribute as a filter or as a visible column in the Intercom inbox.

  • Intercom attachment file type restrictions can block imports

    Intercom does not accept certain file types as conversation attachments because they may contain malware. The restricted list includes .exe, .sys, .scr, .shb, .wsf, and others. Help Scout conversations that contain attachments of these types will fail to attach in Intercom. Before migration begins, we scan the Help Scout conversation history for restricted file types and provide a report. You must enable 'Allow more file types' in Intercom Settings > Security > Attachment settings, list the specific types you need, and acknowledge the security risk. We cannot import restricted file types without this configuration in place.

  • Custom Fields may not exist on Standard-plan source accounts

    Help Scout Custom Fields (Dropdown, Single line, Multi line, Number, Date) are available only on Plus and Pro plans. Accounts on Free or Standard tier do not have Custom Fields in their schema, so attempting to map custom field data will result in a no-op. We detect the source account's plan tier during scoping. If you are on Standard and believe you have custom fields (which are technically Customer Properties on that tier), we map those to standard Intercom Contact fields where possible and flag the remainder as custom attributes. Upgrade to Plus before migration if you need all custom field data preserved.

  • Reporting data cannot be extracted via the Help Scout API

    Help Scout's reporting data (CSAT scores, response time metrics, happiness ratings, channel performance reports, agent productivity stats) is available only as a manual CSV or XLSX export from the Reports UI. It is not accessible via the Inbox API or Docs API. We do not migrate reporting metrics programmatically. Before migration, we ask customers to export the Reports section manually from Help Scout. For Intercom reporting setup post-migration, the historical Help Scout data serves as a baseline; Intercom starts its reporting timeline from the go-live date.

  • Help Scout Docs hierarchy maps to a two-level Intercom structure

    Help Scout Docs supports three-level hierarchy: Collections > Sub-collections > Articles. Intercom's Help Center supports two levels: Sections > Articles. We map Collections to Sections directly. Sub-collections require a decision: either promote Sub-collections to top-level Sections in Intercom (flattening the hierarchy but preserving the content), or nest all Sub-collection articles under the parent Collection as a Section. We present both options during scoping and apply the chosen strategy before migration begins. Multi-language article translations in Help Scout Docs map to Intercom's multi-language article feature, which requires the Intercom Pro or Enterprise plan.

Migration approach

Six steps for a successful Help Scout to Intercom data migration

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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

Context on both ends of the pair

Help Scout logo

Help Scout

Source

Strengths

  • Email-first interface with an inbox layout that mirrors how support agents actually work
  • Knowledge base (Docs) with a clean editor and Beacon widget for embedded self-service
  • Unlimited users on paid plans regardless of team size
  • Contact-based pricing model that is transparent and predictable
  • Automatic Workflows for basic routing and triage included at no extra cost

Weaknesses

  • Reporting is basic — no custom or real-time analytics, limited segmentation, and historical data requires manual CSV export
  • Contact billing caps (50 on Free, 100 on Standard) can catch teams off guard on import
  • No native ticket numbering — conversations are identified by a unique ID not visible to customers
  • Omnichannel depth is shallow — email and chat only, no voice/SMS/WhatsApp without third-party integrations
  • Custom Fields, advanced permissions, and Salesforce integration are gated behind the Plus tier ($83/mo)
Intercom logo

Intercom

Destination

Strengths

  • Integrated AI agent (Fin) for automated resolution with per-resolution billing that rewards high automation rates.
  • Multi-channel inbox consolidating live chat, email, SMS, WhatsApp, and Phone into a single threaded view.
  • Native help center with articles, collections, and self-service deflection capabilities.
  • Workflow automation for routing, qualification, and proactive outbound messaging across channels.
  • Strong API ecosystem with 10,000 req/min rate limits for private apps enabling high-throughput migration pipelines.

Weaknesses

  • Pricing model compounds with seat count, AI resolution fees, channel costs, and multiple add-ons, making total cost hard to predict.
  • Workspace-level isolation prevents moving workflows or content between environments, requiring manual rebuilds.
  • S3 JSON export deliberately excludes conversation transcripts, necessitating REST API calls for full message history.
  • Outages are reported as frequent enough to be a concern for always-on support operations.
  • Setup complexity means teams often require internal guidance or professional services to configure bots and automation correctly.

Complexity grading

How hard is this migration?

Moderate Helpdesk migration. 4 of 7 objects need a mapping; the rest are 1:1.

C

Overall complexity

Moderate migration

Derived from compatibility, mapping clarity, API constraints, and data volume across Help Scout and Intercom.

  • Object compatibility

    C

    4 of 7 objects need a mapping; the rest are 1:1.

  • Field mapping clarity

    C

    Field mapping is derived from defaults — final spec confirmed during the sample migration.

  • Timeline complexity

    B

    7-object category — typical timelines run 2–7 days end-to-end.

  • API constraints

    B

    Help Scout: Per-account limit measured per 10-minute window; exact limits vary by plan tier and are not publicly disclosed.

  • Data volume sensitivity

    B

    Help Scout doesn't expose a bulk API — REST + parallelization used for high-volume runs.

Estimator

Estimate your Help Scout to Intercom migration cost

Rule-based pricing — no per-record fees, no manual quotes. Migrations over 2M records are scoped individually.

Step 1

What are you migrating?

Pick a category, then your source and destination platforms.

Category

FAQ

Frequently asked questions about Help Scout to Intercom data migrations

Answers to the questions buyers ask most during Help Scout to Intercom migration scoping. Not seeing yours? Book a call.

Can't find your answer?

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 consultation

Migrations under 10,000 Conversations, 5,000 Contacts, and 500 Docs articles typically complete in one to three weeks. Accounts with larger knowledge bases (1,000+ articles), complex three-level Docs hierarchies, or multiple Mailboxes with routing logic move into four to seven weeks because of the hierarchy flattening decision process and the per-inbox custom attribute configuration. The most time-consuming factor is the Docs migration, where we coordinate with your team on how to map Collections and Sub-collections to Intercom's two-level Help Center structure.

Adjacent paths

Related migrations to explore

Ready when you are

Move from Help Scout.
Land in Intercom, intact.

Tell us record counts and timeline. We'll come back with a written quote inside 1 business day — no commitment, no sales pitch.

Accuracy guarantee Rollback included Quote in 1 business day