marcelkolano-alt/agenthail-n8n-approval-example — explained in plain English
Analysis updated 2026-07-25
Add a human approval step before an automated workflow sends emails or updates records.
Pause an AI agent's proposed action until a person reviews and approves it.
Safely retry automated tasks without losing context after a system restart.
| marcelkolano-alt/agenthail-n8n-approval-example | 0xkinno/neuralvault | 0xlocker/d17-contracts | |
|---|---|---|---|
| Stars | 1 | 1 | 1 |
| Language | — | TypeScript | Solidity |
| Setup difficulty | easy | hard | hard |
| Complexity | 2/5 | 4/5 | 5/5 |
| Audience | ops devops | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires an n8n 2.x instance and an AgentHail account with an API key.
{"i": 0, "repo": "marcelkolano-alt/agenthail-n8n-approval-example", "stars": 1, "lang": null, "ok": true, "char_count": 1850, "text": "This repository contains an example workflow for n8n, a tool for automating tasks by connecting different services together. The specific scenario shown here is called a human-in-the-loop approval process. An automated agent proposes an action, then pauses and waits for a real person to review that proposal and say yes or no. Only after the human approves does the workflow continue and carry out the action. The example uses a service called AgentHail to manage the review and decision.\n\nThe workflow follows a clear sequence. First, it constructs an exact proposed action and submits it to AgentHail along with a unique identifier that prevents duplicate submissions if something retries. Then it saves key details like the proposal ID, a requester token, a version number, and a payload hash. After that, it waits and checks AgentHail on a regular schedule, every two minutes by default, to see if a human has made a decision. If the proposal is approved, the workflow verifies the receipt from AgentHail matches the saved details and resumes using the original action. If the proposal is rejected or expires, the workflow stops.\n\nA key feature of this example is that it is restart-safe. If n8n restarts while the workflow is waiting for a human decision, the workflow does not lose its place. When n8n comes back up, it retrieves the same proposal and continues from where it left off. It does not ask an AI model to regenerate the action, which avoids the risk of getting a different result the second time around.\n\nThe setup is straightforward. You need n8n version 2.x and an AgentHail account with an API key. You download the JSON file from this repository, import it into n8n, set up your API key as a credential, and run the workflow. The workflow uses only built-in n8n nodes, so no extra plugins or packages are needed.\n\nThe design prioritizes safety. No API keys are embedded in the exported file. Rejected, expired, or malformed states cause the workflow to stop rather than proceed incorrectly. The final node is a harmless mock that does not actually update any external system, so it is safe to test. The repository includes the workflow file, a short demo video, and a preview image.", "error": null}
An n8n workflow template showing how to pause an automated task and wait for a real person to approve it before continuing. It is safe to restart and won't lose its place while waiting for a human decision.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly ops devops.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.