Repair guides / Diagnosis
n8n says success, but your CRM data is wrong
A successful execution is not the same thing as a correct business result. Start by comparing the record you expected with the record that actually arrived.
Define the result before changing the workflow
For a lead handoff, “the workflow finished” is too vague. A useful acceptance criterion is: one valid event creates one record with the expected email and source identifier. A repeated event should follow an explicitly agreed duplicate policy. An incomplete event should not silently create a bad record.
Write those expectations down first. They give you something concrete to test and stop a cosmetic change from being mistaken for a repair.
What if the workflow succeeds but produces no output?
Check where the item count changes. An empty result can be legitimate, so define when this particular workflow should produce a record. If a known valid test event disappears before the destination, trace the first step where the expected item is missing. Do not treat every empty search as an error.
Trace one fictional event end to end
- At the source: list the exact fields in a safe example. Note which values are required.
- Before the destination: compare the outgoing fields with that example. Look for a value copied from the wrong level or a field that disappeared between steps.
- At the destination: inspect the resulting record, not just the execution indicator. Check the identifier and required fields.
Use an isolated copy with a test destination. Replaying a real event into a live workflow can create another contact, send an email or trigger a payment-related action.
A concrete example from our synthetic demo
We ran eight fictional events through a broken and a repaired workflow in a real local n8n instance. The broken version wrote eight records without email values. The repaired version retained three correct records, while duplicates and invalid inputs were handled separately.
| Test input | Result to verify |
|---|---|
| Complete event | The right fields reach the right record. |
| Repeated event | The agreed duplicate policy is applied. |
| Missing required field | No incomplete record is silently accepted. |
| Temporary destination failure | The failure is visible and recovery is bounded. |
These are test categories, not a universal guarantee. In our demonstration, duplicate protection lives in the local CRM simulator. A real destination needs its own supported implementation, especially when events can arrive at the same time.
What a useful repair handoff contains
Keep the original workflow, the corrected version and a short explanation of the changed path. Save the agreed inputs and observed outputs. Include setup requirements, remaining limitations and a rollback plan. If you cannot explain how a test proves the expected result, sharpen the test before treating the repair as complete.
Read our synthetic case study or download the workflows and test evidence. Nine checks passed in that controlled demonstration; it was not a client deployment.
Want help isolating the fault?
Send the expected result, actual result and a sanitized example. We will assess whether it fits the scoped repair pilot.
Request a fit check ↗