okrunit

n8n community node for OKRunit human-in-the-loop approval gateway

Package Information

Downloads: 953 weekly / 4,316 monthly
Latest Version: 0.9.17

Documentation

n8n-nodes-okrunit

OKRunit community node for n8n. Add human-in-the-loop approvals to any n8n workflow.

Pause your automation, wait for a human to approve or reject, then continue. Works with AI agents, deployment pipelines, financial transactions, content publishing, and any workflow that needs human oversight.

Installation

Community Node (recommended)

  1. In n8n, go to Settings > Community Nodes
  2. Enter n8n-nodes-okrunit
  3. Click Install

Manual Installation

cd ~/.n8n
npm install n8n-nodes-okrunit

Then restart n8n.

Setup

Option 1: OAuth2 (recommended)

  1. In n8n, go to Credentials > New Credential > OKRunit OAuth2 API
  2. The Base URL defaults to https://okrunit.com
  3. Click Connect. You'll be redirected to OKRunit to authorize
  4. Grant access and you're connected

Option 2: API Key

  1. In OKRunit, go to Settings > Connections and create a new connection
  2. Copy the API key (starts with gk_, shown only once)
  3. In n8n, create a new OKRunit API credential with your API key

Nodes

OKRunit

The main action node with these operations:

Resource Operation Description
Approval Create Submit a new approval request for human review
Approval Get Fetch an approval request by ID
Approval List Search/filter approval requests
Comment Add Add a comment to an approval request
Comment List List all comments on an approval request

Create Approval

Required fields:

  • Title - What needs approval (defaults to "Approval request from n8n" if blank)
  • Priority - Low, Medium, High, or Critical

Optional fields (under Additional Fields):

  • Description - Detailed context for the reviewer
  • Action Type - Category like "deploy", "delete", "publish"
  • Callback URL - Webhook URL to receive the decision
  • Metadata - Arbitrary JSON data to attach
  • Expires At - Auto-expire after this datetime
  • Required Approvals - Number of approvals needed (1-10)
  • Context HTML - Rich HTML displayed to approvers

OKRunit Trigger

A polling trigger node that fires on approval events:

Trigger Description
New Approval Request Fires when a new approval is created
Approval Decided Fires when an approval is approved or rejected

Both triggers support optional status and priority filters.

Example: Pause-and-wait pattern

  1. OKRunit node (Create) - creates an approval request with a callback URL
  2. Wait node - pauses the workflow
  3. When someone approves/rejects in OKRunit, the callback resumes your workflow

Alternatively, use the OKRunit Trigger node in a separate workflow to react to decisions.

Resources

License

MIT

Discussion