CRM migration

Migrate from FactBox to Twenty CRM

Field-level mapping, validation, and rollback between FactBox and Twenty CRM. We move data and schema; workflows are rebuilt natively in Twenty CRM.

FactBox logo

FactBox

Source

Twenty CRM

Destination

Twenty CRM logo

Compatibility

83%

10 of 12

objects map 1:1 between FactBox and Twenty CRM.

Complexity

BStandard

Timeline

72–96 hours

Rollback included Accuracy guarantee Field-level validation

Overview

What this migration involves

FactBox organizes legal work around cases, facts, witnesses, and evidence chains — a fundamentally different structure from Twenty CRM's people-centric opportunity pipeline. The migration carries over all structured data: People, Companies, Opportunities, Notes, and Tasks. Custom fields that tracked legal-specific attributes (issue codes, fact categories, evidence types) migrate as Twenty custom fields, but the legal-semantic relationships between facts, evidence, and case issues require manual reconstruction in Twenty's data model designer. FlitStack AI sequences the migration to respect Twenty's import-order constraint: Companies first, then People linked to Companies, then Opportunities linked to both. A delta-pickup window captures any FactBox records modified during cutover. Views, automations, document templates, and integration connections do not transfer — Twenty's workflow builder (limited on Pro, full on Organization) handles rebuild, and the REST/GraphQL API supports custom integration scripts for connections that existed in FactBox. Teams should expect to invest 2–4 weeks in rebuilding FactBox automation logic, as workflow rules, case progression triggers, and deadline reminders have no direct equivalent in Twenty's migration scope.

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

FactBox logo

FactBox

What's pushing teams away

  • Limited public API documentation makes integration with other legal tech tools difficult and custom automation nearly impossible.
  • The platform appears geared toward smaller cases and solo practitioners; larger litigation teams may find collaboration features insufficient.
  • Reviews note the tool works well for organizing facts but lacks broader practice management capabilities some firms need.
  • Some users may outgrow the platform as case volume and complexity increase beyond what FactBox was designed to handle.

Choosing

Twenty CRM logo

Twenty CRM

What's pulling them in

  • Top open-source CRM on GitHub with 40.6K stars, giving teams full source code access and infrastructure ownership without per-feature licensing surprises.
  • Free self-hosting under AGPL-3.0 means unlimited users and custom objects for the cost of cloud infrastructure alone, typically $20–100/month.
  • Pricing page explicitly mocks competitors for charging add-on fees for API access, webhooks, and workflows — transparency that resonates with RevOps teams burned by Salesforce.
  • Unlimited custom objects and fields with no price impact, letting teams shape the data model to their business rather than forcing business into rigid schemas.
  • Modern TypeScript/React/PostgreSQL stack means developer-led teams can extend, self-host, or integrate without fighting legacy architecture.

Object mapping

How FactBox objects map to Twenty CRM

Each row shows how a FactBox object lands in Twenty CRM, including any object-level transformations, lookup resolution, or schema-design dependencies.

Typical mapping — final map is confirmed during the sample migration step.

FactBox

Contact

maps to

Twenty CRM

People

1:1
Fully supported

FactBox contacts migrate as Twenty People records. Email, phone, job title, and address fields map directly. Each contact's primary company link resolves to a Twenty Company by domain match; if no match exists, the company link is preserved as a text field for post-migration resolution.

FactBox

Company

maps to

Twenty CRM

Company

1:1
Fully supported

FactBox company records map directly to Twenty Companies. Industry, employee count, annual revenue, and website fields transfer as-is. FactBox parent-child company hierarchies map to Twenty's company relation field — parent must be migrated first to resolve circular references. Company domain serves as the unique identifier for matching and deduplication during the import process.

FactBox

Case

maps to

Twenty CRM

Opportunity

1:1
Fully supported

FactBox cases become Twenty Opportunities. Case status values (Active, Closed, Pending) map to Opportunity Stage pick-list values your admin configures in Twenty. The case name becomes the Opportunity name; case description maps to the opportunity body or a custom text area field.

FactBox

Fact

maps to

Twenty CRM

Custom field on Opportunity

1:1
Fully supported

FactBox facts (individual data points linked to cases) have no Twenty equivalent. We migrate fact text as a custom field (FactBox_Fact__c) on the related Opportunity, or as a Note attached to the case record for freeform retention. Complex fact hierarchies may require a custom object.

FactBox

Evidence

maps to

Twenty CRM

Note / Custom object

many:1
Mapping required

FactBox evidence records combine document reference, exhibit number, and legal status. The document link migrates as a Note on the related Opportunity; exhibit metadata migrates as custom fields (Evidence_Exhibit__c, Evidence_Type__c). Teams needing full evidence chain tracking should create a custom Evidence object in Twenty.

FactBox

Witness

maps to

Twenty CRM

People + Custom fields

many:1
Fully supported

FactBox witness records include contact info plus witness-specific data (deposition date, testimony summary). Contact fields migrate to a Twenty People record; witness-specific attributes (Witness_Status__c, Deposition_Date__c) become custom fields on the People record or a linked custom Witness object. This requires a two-pass migration where People records are created first before witness-specific custom object records are linked.

FactBox

Document

maps to

Twenty CRM

Note / Attachment

1:1
Fully supported

FactBox documents linked to cases migrate as Notes on the related Opportunity. Document name becomes the Note title; document content or file reference becomes the Note body or a link field. Large file attachments are re-uploaded to Twenty's storage with the original filename preserved.

FactBox

Issue

maps to

Twenty CRM

Custom field on Opportunity

1:1
Fully supported

FactBox issues (legal issues tracked per case) have no direct Twenty equivalent. Issue names and codes migrate as a custom multi-select field (Case_Issue__c) on the Opportunity object, enabling filtering and reporting by legal issue in Twenty's views. This allows teams to maintain issue categorization without losing the ability to segment cases by legal matter type.

FactBox

Activity (tasks, notes, events)

maps to

Twenty CRM

Task / Event

1:1
Fully supported

FactBox activities logged against cases migrate as Twenty Tasks or Events on the related Opportunity. Original timestamps and assigned user preserved during migration. If FactBox tracks calendar events with specific start and end times, these map to Twenty Events with full datetime preservation for calendar synchronization and deadline tracking.

FactBox

Custom fields (any object)

maps to

Twenty CRM

Custom fields

1:1
Fully supported

All FactBox custom fields on contacts, companies, cases, witnesses, and evidence migrate as Twenty custom fields. Field types map: text→text, number→number, date→date, picklist→select, multi-select→multi-select. Custom fields must be created in Twenty Settings → Data Model before migration runs to avoid import errors or skipped field values.

FactBox

User / Owner

maps to

Twenty CRM

WorkspaceMember

1:1
Fully supported

FactBox users are matched to Twenty Workspace Members by email. Unmatched owners are flagged before migration — your team invites them to Twenty first or assigns records to a fallback member. No record lands in Twenty without a resolved owner to maintain accountability and assignment integrity.

FactBox

Integration connections

maps to

Twenty CRM

None — rebuild required

1:1
Fully supported

FactBox integrations with billing systems, document platforms, or court e-filing services do not transfer to Twenty. Twenty's REST/GraphQL API and webhook support enable rebuilding these connections using custom scripts or middleware. FlitStack provides an integration reference document listing each connection that requires rebuild, including endpoint URLs, authentication methods, and payload formats from the original FactBox configuration.

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.

FactBox logo

FactBox gotchas

Medium

Annual subscription does not auto-renew

High

Limited public API documentation

Medium

File attachment handling requires separate migration

Twenty CRM logo

Twenty CRM gotchas

High

Import order is enforced and critical

High

Export limited to 20,000 records and visible columns only

Medium

Soft-deleted records count toward uniqueness and trigger restores

Medium

API rate limits cap at 200 req/min on Organization tier

Low

No native email sequences — follow-up cadences require external tools

Pair-specific challenges

  • FactBox's fact-and-evidence hierarchy has no direct Twenty CRM equivalent

    FactBox tracks facts, evidence exhibits, and witness testimony as structured records with legal relationships (fact supports issue, evidence proves fact, witness provides testimony). Twenty CRM has no native concept of evidence chains or fact hierarchies — facts migrate as custom fields or Notes, and the semantic links between facts, evidence, and legal issues are severed. Teams needing full evidentiary chain tracking must design a custom Evidence object in Twenty's data model designer before migration, then map FactBox relationships into that structure manually.

  • FactBox workflows and case automation rules do not transfer to Twenty

    FactBox workflows that automate case progression, deadline reminders, or document generation have no equivalent in Twenty's migration scope. Twenty's workflow builder (limited on Pro, 50 credits/year; full automation on Organization tier) must be rebuilt from scratch. FlitStack exports FactBox workflow definitions as a reference document your admin uses to rebuild in Twenty, but the automation logic itself does not migrate. This is a planning assumption — timeline impact is real and should be accounted for during migration planning.

  • Twenty requires custom fields to exist before CSV import runs

    Twenty's CSV import process creates records but does not create fields — if a FactBox custom field maps to a Twenty custom field that doesn't exist, the import will error or skip that field. FlitStack generates a Twenty schema setup plan listing every custom field to create (with field type, select options, and relation configuration) before the migration run. This adds a pre-migration step where your Twenty admin creates the fields in Settings → Data Model, verified before data movement begins.

  • Witness records split across People and custom fields

    FactBox witness records combine contact information with witness-specific data (deposition date, testimony status). Twenty's People object holds contact fields only — witness metadata must become custom fields on the People record or a linked custom Witness object. If you choose the custom Witness object approach, the migration must create People records for contacts first, then create Witness records linked by email match. This two-pass approach extends migration time for witness-heavy FactBox instances.

  • FactBox's document attachments re-host as Notes with file references

    FactBox stores documents as linked files within case records. Twenty's import process handles attachments as Notes with body text or file URLs — large file attachments are re-uploaded to Twenty's storage (or linked via URL if stored externally). Document version history maintained in FactBox does not transfer; only the current file version migrates to Twenty. If document versioning is legally material, retain a FactBox archive or export documents separately before cutover to preserve version history for compliance purposes.

Migration approach

Six steps for a successful FactBox to Twenty CRM data migration

  1. Audit FactBox data and design Twenty schema

    FlitStack extracts a full inventory of FactBox objects, custom fields, and record counts. We cross-reference with Twenty's data model designer to identify standard-object mappings and custom fields needed for legal-specific attributes. Your Twenty admin creates all custom fields (Evidence_Exhibit__c, Case_Issue__c, Witness_Deposition_Date__c, etc.) in Settings → Data Model before migration runs. We also invite all team members to Twenty at this stage so user resolution by email works during import.

  2. Map and transform data model

    FlitStack builds the field-level mapping document: FactBox contacts → Twenty People, companies → Companies, cases → Opportunities with status-to-stage value mapping, witnesses → People plus custom fields, evidence → Notes plus custom fields. Value mappings are configured for pick-list fields (case status, evidence type, case type) where FactBox values don't match Twenty defaults. All transformation logic (date formats, text truncation, owner email resolution) documented in the mapping spec.

  3. Run sample migration with field-level diff

    A representative slice (200–500 records across contacts, companies, cases, witnesses, and evidence) migrates first. FlitStack generates a field-level diff between the FactBox source values and Twenty destination values so you verify that case status values mapped correctly, witness custom fields populated, and evidence exhibits attached to the right Opportunities. You approve the sample before the full run commits. Any mapping corrections happen here.

  4. Full migration with delta-pickup window

    Full migration runs against Twenty's API, respecting the import order constraint (Companies → People → Opportunities → Notes/Tasks). A delta-pickup window (24–48 hours after initial run) captures any FactBox records modified during cutover. Audit log records every operation. Owner resolution flags any FactBox users not matched to Twenty Workspace Members for manual assignment. One-click rollback is available if reconciliation finds unexpected divergences.

  5. Post-migration reconciliation and rebuild planning

    FlitStack delivers a reconciliation report comparing FactBox record counts against Twenty record counts per object, with a field-level completeness score. We export a FactBox workflow reference document listing every automation rule that needs rebuilding in Twenty's workflow builder. Integration connections (billing, document management, court filing) are documented with their configuration requirements so your developer can rebuild them against Twenty's REST/GraphQL API. Your team configures Twenty page layouts and sharing rules at this stage.

Platform deep dives

Context on both ends of the pair

FactBox logo

FactBox

Source

Strengths

  • Fact-centric data model directly supports litigation workflow from document intake to trial preparation.
  • Automatic fact extraction from uploaded documents speeds up case organization significantly.
  • Physical data security with biometric readers, 2-factor access, and armed guards protects sensitive case data.
  • Immediate productivity—attorneys report being productive on day one without training or technical support.

Weaknesses

  • Minimal public API documentation limits integration options and custom automation capabilities.
  • Collaboration features may be insufficient for large litigation teams handling complex, multi-party cases.
  • The platform appears optimized for smaller matters; enterprise-scale case management features may be limited.
Twenty CRM logo

Twenty CRM

Destination

Strengths

  • AGPL-3.0 open-source license with full source code on GitHub — no vendor lock-in, no sunset risk.
  • Unlimited users and unlimited custom objects on self-hosted, with no feature gating based on headcount.
  • REST and GraphQL APIs available on all paid tiers, not locked behind an enterprise add-on fee.
  • MCP server and webhooks shipped as standard features, not premium upgrades.
  • Modern PostgreSQL-backed data model that developer teams can query, extend, and self-host.

Weaknesses

  • Recent v1.0 release means limited production hardening compared to CRMs with multi-year operational track records.
  • No native email sequencing or sales engagement tools — follow-up cadences require a separate platform.
  • No native two-way email sync or inbox integration, requiring third-party connectors for full activity logging.
  • Self-hosting 'free' pricing hides real infrastructure and DevOps costs that stack up over time.
  • Workflow automation is functional but lacks the complexity needed for sophisticated multi-step sales motions.

Complexity grading

How hard is this migration?

Standard CRM migration. 2 of 8 objects need a mapping; the rest are 1:1.

B

Overall complexity

Standard migration

Derived from compatibility, mapping clarity, API constraints, and data volume across FactBox and Twenty CRM.

  • Object compatibility

    B

    2 of 8 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

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

  • API constraints

    B

    FactBox: Not applicable — no public API endpoints are published..

  • Data volume sensitivity

    B

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

Estimator

Estimate your FactBox to Twenty CRM 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 FactBox to Twenty CRM data migrations

Answers to the questions buyers ask most during FactBox to Twenty CRM migration scoping. Not seeing yours? Book a call.

Can't find your answer?

Walk through your FactBox to Twenty CRM migration with a real engineer — 30 minutes, free, written quote within 24 hours.

Book a free 30 minute consultation

Small FactBox instances (under 25,000 records across contacts, companies, cases, and documents) typically complete in 72–96 hours of clock time for the data migration itself. Larger instances exceeding 100,000 records or those with dense witness-and-evidence schemas extend to 5–10 days of processing time. The longest planning step is designing the Twenty custom schema for FactBox's legal-specific attributes before data movement begins, which adds 3–5 days of preparation time depending on schema complexity.

Adjacent paths

Related migrations to explore

Ready when you are

Move from FactBox.
Land in Twenty CRM, 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