Package Information
Documentation
n8n-nodes-runbook
This is an n8n community node. It lets you use Runbook in your n8n workflows.
Runbook is a repeatable task list manager that helps teams blend manual and automated steps to define, run, and audit critical business processes.
n8n is a fair-code licensed workflow automation platform.
Installation
Operations
Credentials
Compatibility
Usage
Resources
Installation
Follow the installation guide in the n8n community nodes documentation.
Operations
This package includes two nodes: Runbook and Runbook Trigger.
Runbook Node
Manage your Runbook resources directly from n8n workflows.
| Resource | Operations |
|---|---|
| Tasklist | Add task, Update tasklist, Add comment |
| Task | Update task, Add comment |
| Tasklist Template | Create template, Create tasklist, Add task template, Update template |
| Task Template | Update task template |
| Task Group | Create, Update, Remove |
| Task Template Group | Create, Update, Remove |
| Organization Member | Add member, Edit role, Remove member, Resend invitation |
| Team | Create, Update, Remove |
Runbook Trigger Node
Listen for Runbook events via webhooks:
- Task Comment Added — triggers when a comment is added to a task
- Task Completed — triggers when a task is marked complete
- Tasklist Comment Added — triggers when a comment is added to a tasklist
- Tasklist Completed — triggers when a tasklist is completed
- Tasklist Created — triggers when a new tasklist is created
Events can optionally be filtered by tasklist template, tasklist, task template, or task.
Credentials
Runbook OAuth2 API
Used for all Runbook node operations.
- Sign up at runbook.uplift.ltd
- Create an OAuth2 application in Organization Settings and copy the Client ID + Secret.
- In n8n, create a new Runbook OAuth2 API credential
- Complete the OAuth2 authorization flow.
Runbook HMAC Secret API
Used for webhook signature verification in the Runbook Trigger node.
- Obtain your HMAC secret from your Runbook webhook configuration
- In n8n, create a new Runbook HMAC Secret API credential and enter the secret
Compatibility
Tested with n8n v2.x. Requires n8n Node API version 1.
Usage
Automating tasklist creation
Use the Tasklist Template → Create Tasklist operation to spin up new tasklist instances from a template. Combine with the trigger node to chain automated steps — for example, create a follow-up tasklist when another one completes.
Updating tasks from external systems
Use the Task → Update Task operation to mark tasks complete, change assignees, or update progress from external events. This is useful for automating steps that depend on signals from other tools in your workflow.
Reacting to Runbook events
Use the Runbook Trigger node to kick off n8n workflows when key events happen in Runbook — such as notifying a Slack channel when a tasklist is completed, or syncing task status to an external project tracker.
Incident response
When an alert fires in a monitoring tool (e.g., PagerDuty, OpsGenie), use Tasklist Template → Create Tasklist to spin up an incident response runbook automatically. Assign the tasklist to the on-call team and use the Runbook Trigger to notify stakeholders or resolve the incident ticket once the checklist is complete.
Employee onboarding
Connect your HR system (e.g., BambooHR, Workday) to automatically create an onboarding tasklist when a new hire is added. Use Organization Member → Add Member to grant them access, and trigger downstream actions — like provisioning accounts or sending welcome emails — when specific tasks are completed.
Deployment checklists
After a CI/CD pipeline succeeds, use Tasklist Template → Create Tasklist to generate a post-deploy verification checklist. When the Runbook Trigger fires on tasklist completion, mark the release as verified or update your deployment tracker.
Syncing with project management tools
Use the Runbook Trigger to sync task status back to Jira, Linear, or GitHub Issues. When a task is completed in Runbook, close the corresponding ticket. Conversely, use Task → Update Task to check off Runbook tasks when issues are resolved externally.
Customer onboarding (SaaS)
When a new customer is created in your CRM (e.g., HubSpot, Salesforce), use Tasklist Template → Create Tasklist to start a customer onboarding checklist. Trigger follow-up actions — like scheduling a check-in call or sending a resources email — when the onboarding tasklist is completed.
Scheduled compliance checklists
Use an n8n Schedule trigger to automatically create monthly or quarterly compliance checklists from a template. When the checklist is completed, the Runbook Trigger can generate a report or notify your compliance team.
Reporting and notifications
Combine Task Completed and Tasklist Completed triggers with messaging tools (Slack, Teams, email) to keep stakeholders informed in real time. Post task-by-task progress updates or a final summary when the runbook finishes.