Helpdesk migration
Field-level mapping, validation, and rollback between House-on-the-Hill Service Desk and Gorgias. We move data and schema; workflows are rebuilt natively in Gorgias.
House-on-the-Hill Service Desk
Source
Gorgias
Destination
Compatibility
7 of 12
objects map 1:1 between House-on-the-Hill Service Desk and Gorgias.
Complexity
CModerate
Timeline
2-4 weeks
Overview
Moving from House-on-the-Hill Service Desk to Gorgias is a structural migration because House-on-the-Hill has no public REST API — all data access relies on CSV flat-file exports from the Settings Cog UI, while Gorgias exposes a REST API with rate-limited bulk endpoints. We bridge that gap by extracting each source table independently (Contacts, Companies, Agents, Tickets, Conversations, Attachments, KB Articles) as denormalised CSV, then ingesting them into Gorgias via the REST API in dependency order: Contacts and Companies first, then Agents, then Tickets, then Conversations threaded into tickets, then Attachments re-linked via the returned ticket ID map. SLA assignments, custom field names, and tag labels carry across as explicit field mappings. House-on-the-Hill Workflows, email processing rules, and SLA policy definitions do not migrate; we deliver a written inventory of these for the customer's admin to rebuild in Gorgias.
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 House-on-the-Hill Service Desk object lands in Gorgias, including any object-level transformations, lookup resolution, or schema-design dependencies.
Typical mapping — final map is confirmed during the sample migration step.
House-on-the-Hill Service Desk
Contact
Gorgias
Customer
1:1House-on-the-Hill stores contacts as a separate database and exports them via CSV. We import them first into Gorgias as Customer records so that the customer_id reference is satisfied before ticket import. The source email address is the dedupe key; first_name, last_name, and phone map directly. Any Hoth contact custom fields map to Gorgias customer attributes. If Hoth stores organisation in a separate company field, we resolve it against the imported Company records before inserting the customer.
House-on-the-Hill Service Desk
Company
Gorgias
Organization
1:1House-on-the-Hill companies (organisations) are a separate database export. We import them into Gorgias as Organization records before customers, so that the customer-to-organization linkage is established via the customer.organization_id field. The Hoth company name and domain fields map to Gorgias Organization name and website. Where Hoth stores a flat contact model without explicit company linking, we derive the organisation relationship from the customer's email domain.
House-on-the-Hill Service Desk
Agent
Gorgias
Agent / User
1:1Agent accounts in House-on-the-Hill are stored in a distinct database but the HTTPS Report API does not expose agent records for automated export. We export agent data from the UI CSV export where available, then map source agent email, name, and role to Gorgias User records. Any Hoth role or permission set that has no direct Gorgias equivalent is noted as a configuration step for the customer's admin post-migration.
House-on-the-Hill Service Desk
Ticket
Gorgias
Ticket
1:1House-on-the-Hill tickets are the primary record type and export cleanly from Settings Cog > More Tools. We map source ticket ID (preserved as external_id for reconciliation), subject, status (Open/Closed/Pending mapped to Gorgias channel states), priority, assignee (resolved to the imported Agent User ID), created_at timestamp, and updated_at timestamp. Custom ticket fields defined in the Hoth form designer map to Gorgias ticket attributes and are created as custom ticket fields in the destination before migration.
House-on-the-Hill Service Desk
Conversation
Gorgias
Ticket message
1:1Ticket conversations (public replies and internal notes) in House-on-the-Hill are stored as a related database table. We export the conversation thread linked to each ticket by ticket reference number and import them after tickets are inserted, using the source ticket external_id to resolve the destination ticket_id. Public customer replies and agent responses map to Gorgias channel-specific message types (email_message, chat_message, etc.) ordered by the source created_at timestamp.
House-on-the-Hill Service Desk
Attachment
Gorgias
Attachment
1:1File attachments in House-on-the-Hill are stored in the document management system and linked to tickets by an internal document ID. The ticket CSV does not embed attachment binary data. We export all attachment records as a separate pass, download the binary files, upload them to Gorgias as attachments via the REST API, then use the migrated ticket ID map returned by our import engine to set the ticket_id reference on each uploaded attachment. This two-phase approach avoids broken attachment references in the final dataset.
House-on-the-Hill Service Desk
Tag
Gorgias
Tag
lossyTags in House-on-the-Hill are a flat label system applied to tickets as a comma-separated string per record. We export tags as a delimited string and split them into the destination tag array at import time. Duplicate tag values are deduplicated before insert. If Gorgias uses a separate tag management schema, we configure the tag array on the ticket during import and note any tag merge or rename requirements for the customer's admin.
House-on-the-Hill Service Desk
SLA Record
Gorgias
SLA Policy
lossySLA policies and their ticket associations in House-on-the-Hill are not independently exportable; SLA name and breach time are embedded in the ticket record. We extract SLA metadata from the ticket export, then recreate SLA rules in Gorgias as SLA Policies with matching first-response and next-response time targets. The SLA assignment per ticket is re-applied at import time using the imported SLA Policy IDs. SLA policy configuration is validated in a pre-migration test pass before the full import.
House-on-the-Hill Service Desk
Knowledge Base Article
Gorgias
Help Center Article
1:1KB articles in House-on-the-Hill are stored separately from tickets in the knowledge base module. We export them as structured records including article title, body content (mapped as HTML or rich text), category assignments, and any custom article fields. Article-body HTML is preserved and imported into Gorgias Help Center with the original category hierarchy mapped to Gorgias Help Center categories. Article-to-ticket linkage (if any Hoth articles are linked to specific ticket resolutions) is noted for manual re-linking or macro reconstruction.
House-on-the-Hill Service Desk
Custom Field
Gorgias
Custom Attribute
lossyCustom ticket and contact fields defined in the House-on-the-Hill form designer are exported as part of the respective CSV template. We inspect the field schema from the export template, create equivalent custom attributes in Gorgias (ticket attributes for ticket fields, customer attributes for contact fields) before migration begins, and map each source custom field name and value to the destination field. Dropdown, checkbox, and multi-select field values are mapped to the equivalent Gorgias attribute type.
House-on-the-Hill Service Desk
Email Processing Rule
Gorgias
Not migrated
lossyHouse-on-the-Hill supports automatic email processing rules that create tickets from mailbox interrogations and send emails at specific lifecycle points. These rules are platform-specific configurations that do not have a Gorgias equivalent as a migrated artifact. We document every active email processing rule in the House-on-the-Hill configuration (triggers, conditions, mailbox assignments) and deliver it as a written spec for the customer's admin to implement using Gorgias Rules and macros post-migration.
House-on-the-Hill Service Desk
Workflow / Automation
Gorgias
Not migrated
lossyHouse-on-the-Hill workflow definitions (automated actions triggered by ticket state changes, assignment rules, or SLA breach events) do not migrate. We inspect the Hoth configuration for any active automated rules and deliver a written inventory specifying each rule's trigger, conditions, actions, and a recommended Gorgias Rule equivalent. The customer's admin rebuilds automations in Gorgias using the Gorgias Rules engine post-migration.
| House-on-the-Hill Service Desk | Gorgias | Compatibility | |
|---|---|---|---|
| Contact | Customer1:1 | Fully supported | |
| Company | Organization1:1 | Fully supported | |
| Agent | Agent / User1:1 | Fully supported | |
| Ticket | Ticket1:1 | Fully supported | |
| Conversation | Ticket message1:1 | Fully supported | |
| Attachment | Attachment1:1 | Fully supported | |
| Tag | Taglossy | Fully supported | |
| SLA Record | SLA Policylossy | Fully supported | |
| Knowledge Base Article | Help Center Article1:1 | Fully supported | |
| Custom Field | Custom Attributelossy | Fully supported | |
| Email Processing Rule | Not migratedlossy | Fully supported | |
| Workflow / Automation | Not migratedlossy | 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.
House-on-the-Hill Service Desk gotchas
CSV import requires flat file format with no nested structures
Import error log is written to _suppdesk.err_ with no UI summary
Attachments must be exported and re-linked separately from tickets
Gorgias gotchas
AI Agent adds outcome-based fees on top of billable ticket costs
Overage billing for tickets scales nonlinearly
API rate limits restrict bulk export throughput
Agent data visibility cannot be restricted by role for GDPR use cases
Knowledge Base translations require separate API calls per locale
Pair-specific challenges
Migration approach
Discovery and source audit
We audit the House-on-the-Hill instance for record volumes across Contacts, Companies, Agents, Tickets, Conversations, Attachments, KB Articles, and any active SLA policies. We inspect the Settings Cog export templates to identify custom field names, data types, and which tables are available for export versus which must be manually navigated. We review any active email processing rules, automated routing logic, and SLA configurations that will not migrate. The discovery output is a written migration scope specifying record counts, required field mappings, and the list of automations requiring manual rebuild.
CSV extraction in dependency order
We export each House-on-the-Hill table independently via the Settings Cog CSV export: Companies first, then Contacts, then Agents, then Tickets, then Conversations, then Attachments (metadata only), then KB Articles. We denormalise related tables (conversation threads linked to ticket reference numbers, attachment records linked to ticket document IDs) into flat files suitable for import. We parse the _suppdesk.err_ error log after each export pass to identify any malformed rows before proceeding to destination ingestion.
Gorgias schema provisioning
Before any data ingestion, we create the target schema in Gorgias: custom ticket attributes and customer attributes matching each House-on-the-Hill custom field, Help Center categories matching the KB article hierarchy, and SLA Policies with time targets matching the Hoth SLA metadata extracted from the ticket export. We configure the Gorgias inbox channels (email, chat, SMS as applicable) that will receive the migrated tickets. This step validates that Gorgias field types can accommodate the source data before any load begins.
Sample migration and mapping validation
We run a sample migration using a subset of records (typically 50-100 tickets with associated contacts and conversations) to validate the field mapping, verify that custom attributes are rendering correctly in Gorgias, and confirm that attachment re-linking is working. We reconcile record counts between the sample CSV exports and the Gorgias API responses. Any mapping corrections (field type mismatches, encoding issues, missing required fields) are resolved here before the full migration begins.
Full migration in dependency order
We run the full migration in record-dependency order: Organizations (Companies) first, then Customers (Contacts), then Users (Agents), then Tickets with assignee_id resolved to the imported User IDs, then Ticket Messages (Conversations) threaded by source ticket external_id, then Attachments re-linked via the returned ticket ID map, then KB Articles. Each phase emits a row-count reconciliation report before the next phase begins. We apply Gorgias API rate-limit handling with batch chunking and exponential backoff throughout.
Cutover, validation, and automation rebuild handoff
We freeze House-on-the-Hill writes during the final cutover window and run a delta migration of any records modified during the migration process. We validate the Gorgias data against source record counts and spot-check 25-50 records for field-level accuracy. We deliver the email processing rule and automation inventory document to the customer's admin for Gorgias Rules rebuild. We support a brief hypercare window to resolve reconciliation issues. We do not rebuild House-on-the-Hill Workflows or automations as Gorgias Rules inside the migration scope; that is a separate engagement.
Platform deep dives
House-on-the-Hill Service Desk
Source
Strengths
Weaknesses
Gorgias
Destination
Strengths
Weaknesses
Complexity grading
Moderate Helpdesk migration. 3 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 House-on-the-Hill Service Desk and Gorgias.
Object compatibility
3 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
House-on-the-Hill Service Desk: Not publicly documented.
Data volume sensitivity
House-on-the-Hill Service Desk 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 House-on-the-Hill Service Desk to Gorgias migration scoping. Not seeing yours? Book a call.
Walk through your House-on-the-Hill Service Desk to Gorgias migration with a real engineer — 30 minutes, free, written quote within 24 hours.
Book a free 30 minute consultationAdjacent paths
Other ways to leave House-on-the-Hill Service Desk
Other ways to arrive at Gorgias
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.