Free self-check ยท no signup

12 Gaps in an n8n Client Handover

For freelancers and small agencies who build n8n workflows for clients. Work through it against the last project you handed over โ€” not the one you wish you had handed over.

~8 min read12 gaps ยท 4 parts ยท score at the end

This is a checklist, not advice about your contract, your taxes or your legal obligations. It does not promise your automations will stop failing โ€” it only helps you see, before your client does, which parts of the handover were never actually agreed.

Part A โ€” Ownership

Who actually holds the keys.

01 The n8n instance itself has no named owner

What it looks like: the workflows run on a VPS, a Docker host or an n8n Cloud account, and nowhere in writing does it say who pays for it, who is the admin, and who can restore it if the box dies.

Why it costs you: the day the client wants to move on, or the day the host suspends the account, you become the single point of failure for infrastructure you were never paid to operate.

The fix: one line in the handover document โ€” instance type, who pays, who is admin, who is the backup admin.

Check: if you disappeared for two weeks, could the client log into the instance without contacting you?

02 Credentials live under your identity, not the client's

What it looks like: the Google, Slack, Airtable or CRM credentials inside n8n were created with your own OAuth login, or with an API key generated from your seat.

Why it costs you: every credential expiry, every re-auth, every token rotation comes back to you forever โ€” usually unpaid, usually urgent.

The fix: create credentials from a client-owned service account wherever the vendor allows it, and list every credential with the account it belongs to.

Check: how many credentials in that project are still tied to your personal login?

03 Third-party accounts and paid plans are in your name

What it looks like: you signed up for the LLM API key, the scraping API, the SMS provider or the paid tier that keeps the workflow inside its rate limits.

Why it costs you: you are financing and legally holding accounts for someone else's business, and the workflow silently breaks the month you cancel.

The fix: an account list with owner, plan tier, renewal date and the rate limits that matter.

Check: is there any recurring charge on your card that exists only for this client?

Part B โ€” Visibility

Can the client see what they own.

04 There is no workflow inventory

What it looks like: the client has access to n8n and sees a list of workflow names. That is the entire documentation.

Why it costs you: they cannot tell what is live, what was an experiment, and what is safe to disable โ€” so they ask you, every time.

The fix: one row per workflow: name, purpose in plain language, status (live / paused / experiment), owner, last changed.

Check: could a non-technical person read the list and say what the business gets from each workflow?

05 No trigger and schedule map

What it looks like: nobody has written down what starts each workflow โ€” a webhook, a cron, a poll every 5 minutes, a manual run โ€” or how often it fires.

Why it costs you: "why did this run twice?" and "why didn't this run at all?" become your problem to investigate for free.

The fix: a table of trigger type, frequency, and what the expected volume looks like on a normal day.

Check: do you know, without opening n8n, which workflow has the highest execution count?

06 Nobody documented where the data ends up

What it looks like: the workflow writes to a sheet, a database, a CRM field or a storage bucket, and only you know which one, and in what shape.

Why it costs you: the client's next developer changes a column, the workflow breaks, and you get called.

The fix: for each workflow, name the destination systems and the fields written.

Check: if the client asked "where does this data live?", could you answer from the handover document alone?

Part C โ€” Failure

What happens when it breaks at 2 a.m.

07 No error workflow is wired up

What it looks like: failures appear in the executions list and nowhere else. Or the error notification goes to your inbox only.

Why it costs you: you are the client's monitoring system, unpaid, indefinitely.

The fix: an error workflow attached to every production workflow, sending to a channel the client can also see.

Check: when the last failure happened, who found out first โ€” you, or the client?

08 Retry and duplicate behaviour was never defined

What it looks like: nobody decided what should happen when a step fails halfway โ€” retry how many times, is a re-run safe, will the customer get two emails or an invoice twice.

Why it costs you: the failure mode is discovered in production, on real customer data, and the conversation that follows is not a pleasant one.

The fix: for each workflow, one line: retries, and whether re-running is safe or creates duplicates.

Check: can you re-run yesterday's failed execution right now without causing damage?

09 There is no escalation path

What it looks like: the informal answer to "who do we call at 2 a.m." is "message you on WhatsApp".

Why it costs you: availability you never priced, never scoped and cannot refuse without looking unhelpful.

The fix: written response expectations โ€” what counts as urgent, what your hours are, what is billable, and what the client can do themselves first.

Check: is there anything in writing that tells the client when you are not available?

Part D โ€” Closing

Is the project actually finished.

10 "Done" was never defined

What it looks like: the project ends when the client stops asking for changes, not when an agreed list of criteria is met.

Why it costs you: scope keeps expanding, and the final invoice keeps moving away.

The fix: acceptance criteria written before build, signed off in one message after demonstration.

Check: on your last project, can you point to the moment the client agreed it was complete?

11 The client cannot verify it works without you

What it looks like: you demonstrated it once on a screen share, using data only you know how to produce.

Why it costs you: every future doubt about whether it is working becomes a support request instead of a two-minute check they run themselves.

The fix: a short test procedure with safe sample input and the expected result, that a non-technical person can follow.

Check: could the client prove the workflow still works, today, on their own?

12 There is no offboarding plan

What it looks like: nobody has written down what happens when you leave โ€” which of your accesses get revoked, which exports get handed over, what the client keeps.

Why it costs you: you stay logged into a client's systems for years after the money stopped, which is a risk you carry for free.

The fix: an offboarding list โ€” workflow JSON exports handed over, credentials transferred, your access removed on a named date, confirmed by both sides.

Check: are you still able to log into a client system for a project that ended more than six months ago?

Score yourself

Count the gaps where your honest answer was no, that is not written down anywhere.

Gaps openWhat it usually means
0โ€“2Your handover is in good shape. The remaining gaps are worth closing before your next project.
3โ€“6Normal for a working freelancer. The open gaps are where unpaid support hours tend to accumulate.
7โ€“12Your projects likely never fully close. Each finished client keeps a permanent claim on your attention.

Whatever your number is, the pattern matters more than the score: gaps cluster. If Part A is open, Part D is almost always open too โ€” you cannot offboard cleanly from accounts you still personally own.

What to do next

Pick the single gap that cost you the most time in the last three months and close it for your next project only. Do not retrofit every past client at once; that is a week of work with no invoice attached.

Disagree with one of the twelve? That is the most useful thing you could tell me. I am collecting how people actually handle handover in practice, and the gaps people think are wrong are the ones I learn most from.

[email protected] โ€” one line is enough. No list, no newsletter, no follow-up sequence.