Helpdesk migration
Field-level mapping, validation, and rollback between TeamDynamix IT Service Management and Freshdesk. We move data and schema; workflows are rebuilt natively in Freshdesk.
TeamDynamix IT Service Management
Source
Freshdesk
Destination
Compatibility
7 of 10
objects map 1:1 between TeamDynamix IT Service Management and Freshdesk.
Complexity
BStandard
Timeline
3-5 weeks
Overview
Moving from TeamDynamix ITSM to Freshdesk is a migration from a no-code ITSM platform built for mid-enterprise ITIL workflows to a cloud-native help desk platform optimized for support team agility. TeamDynamix organizes service around Tickets linked to Services, Ticket Forms, Ticket Workflows, and Knowledge Base articles with a hierarchical category structure. Freshdesk uses Tickets, Contacts, Companies, and a separate Knowledge Base with article folders and category assignments. We extract Ticket records and their associated attributes via the TDX REST API, preserve Knowledge Base HTML content and category assignments as structured payloads, and map TeamDynamix Custom Attributes to Freshdesk custom contact and ticket fields with explicit choice-list recreation. Ticket Workflows, Ticket Forms, and Service configurations are documented for admin rebuild; they do not migrate as functional code. Projects from TeamDynamix PPM transfer as grouped task records or a custom object in Freshdesk depending on the selected plan. Assets and Configuration Items migrate with their linked relationships preserved.
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 TeamDynamix IT Service Management object lands in Freshdesk, including any object-level transformations, lookup resolution, or schema-design dependencies.
Typical mapping — final map is confirmed during the sample migration step.
TeamDynamix IT Service Management
Ticket
Freshdesk
Ticket
1:1TeamDynamix Tickets map directly to Freshdesk Tickets. Standard fields (status, priority, assignee, created date, updated date) transfer to their Freshdesk equivalents. Custom Attributes on the ticket attach as Freshdesk custom ticket fields, with choice-list attributes requiring explicit recreation in Freshdesk's custom fields editor before migration. Ticket external ID is preserved as a reference field for reconciliation. TeamDynamix ticket forms and workflows are documented for admin rebuild; they do not migrate as functional code.
TeamDynamix IT Service Management
Knowledge Base Article
Freshdesk
Article (Knowledge Base)
1:1TeamDynamix KB articles are HTML content blocks with category assignments and optional service associations. We extract article HTML, metadata (author, creation date, last modified), and category path as a structured payload. Articles import to Freshdesk as Solution articles with the HTML content mapped to the article description. Category hierarchy in TeamDynamix (which can be deeply nested) may require flattening into Freshdesk's folder structure; we document the hierarchy mapping and apply it during import. Article-to-service associations are noted as tags or category assignments in Freshdesk for admin review.
TeamDynamix IT Service Management
Knowledge Base Category
Freshdesk
Folder (Knowledge Base)
lossyTeamDynamix KB categories form a hierarchical tree. Freshdesk uses flat folders organized within the Knowledge Base section. We map the deepest-level category in TeamDynamix to a Freshdesk folder name, noting that parent categories in the hierarchy are either absorbed into the folder name or documented as a separate categorization system. Deep nesting beyond two levels requires administrative decision on consolidation during migration.
TeamDynamix IT Service Management
Service
Freshdesk
Solution article group or tag
1:1TeamDynamix Services represent published portal offerings linked to ticket forms, request workflows, and KB articles. Freshdesk does not have a native Service Catalog equivalent. We map active Services to Freshdesk Solution categories or Solution article tags, preserving the service name and linking articles that were associated with the service in TeamDynamix. The customer's admin evaluates whether to use Freshdesk's Products module as a lightweight service inventory substitute.
TeamDynamix IT Service Management
User / Agent
Freshdesk
Agent
1:1TeamDynamix User and Agent accounts, including role assignments and group memberships, map to Freshdesk Agents. We match by email address. Group memberships in TeamDynamix map to Freshdesk Groups. Role assignments (Agent, Requester, Admin) are translated to Freshdesk's agent permission levels. Passwords and SSO tokens cannot be migrated; agents must reset credentials post-migration. Inactive TeamDynamix users require admin decision on whether to create inactive agents in Freshdesk for historical record association.
TeamDynamix IT Service Management
Requester / End User
Freshdesk
Contact
1:1TeamDynamix Requester records (end users who submit tickets) map to Freshdesk Contacts. Email, name, phone, and company associations transfer directly. Custom Attributes attached to requester records map to Freshdesk custom contact fields with choice-list recreation. Company associations in TeamDynamix map to Freshdesk Companies where the customer uses the company model.
TeamDynamix IT Service Management
Company
Freshdesk
Company
1:1TeamDynamix Organizations/Companies map to Freshdesk Companies. Company name, domain, address, and custom fields transfer directly. The domain field in TeamDynamix becomes the Freshdesk Company domain field for dedupe matching. Freshdesk's company model is optional and enabled per account; we configure it during setup if the customer uses organization-level ticket routing.
TeamDynamix IT Service Management
Asset / Configuration Item
Freshdesk
Asset
1:1TeamDynamix Assets (hardware and software inventory, discovered or manually added) and Configuration Items with their relationship mappings transfer to Freshdesk Assets. Asset name, type, serial number, purchase date, and custom attributes map to Freshdesk Asset fields. CI relationships between assets (dependency mappings) are preserved as Freshdesk Asset relationship records. Note that Freshdesk's asset management is available on the Growth plan and above; we confirm the destination plan during scoping.
TeamDynamix IT Service Management
Custom Attribute
Freshdesk
Custom Field
lossyTeamDynamix Custom Attributes (typed fields: text, number, choice, date, user reference) attach to Tickets, Services, and other objects. We map these field-by-field to Freshdesk custom fields, matching the field type to Freshdesk's supported custom field types (text, number, date, dropdown, checkbox, paragraph). Choice-list attributes require explicit recreation in Freshdesk's field editor with the same option values before migration runs, because Freshdesk does not accept arbitrary dropdown values that do not exist in the field definition.
TeamDynamix IT Service Management
Project (PPM)
Freshdesk
Custom Object or Task Group
1:manyTeamDynamix PPM project records include project metadata, governance status, time tracking, and task lists. Freshdesk does not have a native PPM module. We extract project records as a custom object (available on Growth and above plans) or as grouped task records with a project identifier tag. Project time entries map to task notes or custom fields. The customer selects the approach during scoping based on their Freshdesk plan.
| TeamDynamix IT Service Management | Freshdesk | Compatibility | |
|---|---|---|---|
| Ticket | Ticket1:1 | Fully supported | |
| Knowledge Base Article | Article (Knowledge Base)1:1 | Fully supported | |
| Knowledge Base Category | Folder (Knowledge Base)lossy | Fully supported | |
| Service | Solution article group or tag1:1 | Fully supported | |
| User / Agent | Agent1:1 | Fully supported | |
| Requester / End User | Contact1:1 | Fully supported | |
| Company | Company1:1 | Fully supported | |
| Asset / Configuration Item | Asset1:1 | Fully supported | |
| Custom Attribute | Custom Fieldlossy | Fully supported | |
| Project (PPM) | Custom Object or Task Group1:many | 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.
TeamDynamix IT Service Management gotchas
Knowledge Base migration is labor-intensive and partially manual
Configuration export/import is separate from data migration
Azure database export requires explicit customer enablement
Freshdesk gotchas
API access is blocked on the free plan
Per-minute rate limits are account-wide and endpoint-specific
Multi-channel source types do not map 1:1 to all destinations
Custom objects created in-product cannot be accessed by other apps
Contact import requires at least 10 existing tickets in the account
Pair-specific challenges
Migration approach
Discovery and export method confirmation
We audit the TeamDynamix instance: ticket volume, KB article count, Custom Attribute list (including every choice-list option), active Services, active Ticket Workflows, asset inventory, and whether Azure database export is enabled. We confirm export method availability with the customer. If database export is not provisioned, we deploy our API-based extraction tool to capture Knowledge Base articles and ticket data as structured JSON. We identify Freshdesk destination plan (Starter/Growth/Premium/Pro) based on required features (asset management, custom objects, automation depth). The discovery output is a written migration scope with a record count per object, a Custom Attribute inventory, and an export method decision.
Custom field recreation in Freshdesk
Before any data moves, we recreate every TeamDynamix Custom Attribute as a Freshdesk custom field. Choice-list attributes are built first with the exact option values from TeamDynamix. Text, number, date, and checkbox fields are mapped to Freshdesk's equivalent types. Freshdesk's ticket custom fields and contact custom fields are created in the admin panel. This step must complete before migration begins because Freshdesk rejects import values for fields that do not exist or for which the option list is incomplete.
KB article extraction and Freshdesk folder structure
We extract Knowledge Base articles from TeamDynamix as structured HTML payloads with category path metadata. We analyze the category hierarchy and flatten it into a Freshdesk folder structure. Active Services from TeamDynamix are mapped to Freshdesk Solution categories or tags. Articles are reformatted to match Freshdesk's article content model, with section headings and inline images preserved. The article import runs after folders are created and before ticket migration so that article links and service associations can be verified.
User and agent provisioning
We extract all TeamDynamix Users and Agents and match by email against the Freshdesk destination. Group memberships are mapped to Freshdesk Groups. Role assignments are translated to Freshdesk agent permission levels. We hold any TeamDynamix users without matching Freshdesk agents in a reconciliation queue for the customer's admin to provision. Passwords and SSO tokens cannot migrate and require re-authentication after cutover.
Ticket migration with attribute resolution
We run ticket migration in dependency order: Contacts (from TeamDynamix Requesters) first, then Companies, then Tickets. Custom Attribute values are resolved at migration time against the Freshdesk custom fields created in Step 2. Each ticket carries its original external ID for reconciliation. We disable Freshdesk automations and notification rules before migration to prevent unintended ticket routing during import. We run at Freshdesk's standard API rate, requesting temporary limit increases for migrations exceeding 25,000 tickets.
Delta migration, cutover, and workflow rebuild handoff
We run a delta migration pass to capture records created or modified during the migration window. We then freeze TeamDynamix writes, run a final delta pass, and enable Freshdesk as the system of record. We deliver the Ticket Workflow and Service configuration inventory document to the customer's admin team. We support a one-week post-cutover window for reconciliation issues. We do not rebuild TeamDynamix Workflows or Service configurations in Freshdesk as part of the migration scope; that is a separate engagement or an internal admin rebuild task.
Platform deep dives
TeamDynamix IT Service Management
Source
Strengths
Weaknesses
Freshdesk
Destination
Strengths
Weaknesses
Complexity grading
Standard Helpdesk migration. 1 of 7 objects need a mapping; the rest are 1:1.
Overall complexity
Standard migration
Derived from compatibility, mapping clarity, API constraints, and data volume across TeamDynamix IT Service Management and Freshdesk.
Object compatibility
1 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
TeamDynamix IT Service Management: Not publicly documented.
Data volume sensitivity
TeamDynamix IT Service Management 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 TeamDynamix IT Service Management to Freshdesk migration scoping. Not seeing yours? Book a call.
Walk through your TeamDynamix IT Service Management to Freshdesk migration with a real engineer — 30 minutes, free, written quote within 24 hours.
Book a free 30 minute consultationAdjacent paths
Other ways to leave TeamDynamix IT Service Management
Other ways to arrive at Freshdesk
Same-Helpdesk migrations
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.