n8n-nodes-runn-dotsandarrows

This is an n8n community node. It lets you use the Runn API in your n8n workflows.

Runn is a resource planning and project forecasting platform. This node allows you to manage people, projects, and clients, and react to changes in real time using the trigger node.

n8n is a fair-code licensed workflow automation platform.

Installation | Operations | Credentials | Compatibility | Usage | Resources | Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

Local Development

# Install dependencies
npm install

# Build before you run
npm run build

# Start n8n with the custom node loaded (recommended)
npm run dev

# Alternative: use globally installed n8n
npm run dev:local

Operations

Actuals

| Operation | Description | | ------------------ | --------------------------------------------------------------------------------------------------- | | Create or Update | Create or update an actual. Overwrites any existing actual for the same date, person, project, role, and workstream. | | Delete | Delete an actual by ID | | Get All | Get all actuals, with an optional Modified After date filter |

Assignments

| Operation | Description | | ----------- | --------------------------------------------------------------------------------------------------------------- | | Create | Create a new assignment. Required: Person ID, Project ID, Role ID, Start Date, End Date, Minutes Per Day. Optional: Billable, Include Non-Working Days, Note, Phase ID, Workstream ID | | Delete | Delete an assignment by ID | | Get All | Get all assignments, with optional filters: Person ID, Project ID, Role ID, Start Date, End Date, Modified After, Only Active |

People

| Operation | Description | | ----------- | ------------------------ | | Archive | Archive a person | | Create | Create a new person | | Delete | Delete a person | | Get All | Get all people | | Get One | Get a single person | | Unarchive | Unarchive a person | | Update | Update a person |

Projects

| Operation | Description | | ------------ | -------------------------- | | Add Note | Add a note to a project | | Archive | Archive a project | | Create | Create a new project | | Delete | Delete a project | | Get All | Get all projects | | Get One | Get a single project | | Unarchive | Unarchive a project | | Update | Update a project |

Clients

| Operation | Description | | ------------- | --------------------- | | Archive | Archive a client | | Create | Create a new client | | Get All | Get all clients | | Get One | Get a single client | | Unarchive | Unarchive a client | | Update | Update a client |

Contracts

| Operation | Description | | ----------- | -------------------------------------------------------------------------------------------------------------- | | Get All | Get all contracts, with optional filters: Modified After, Sort By (id / createdAt / updatedAt), Order (asc / desc) |

Time Offs

| Operation | Description | | ---------------- | ------------------------------------------------------------------------------------------------------------------------ | | Create Leave | Create a leave time off for a person. Automatically merges overlapping time offs. Required: Person ID, Start Date, End Date. Optional: Minutes Per Day, Note. | | Get All Leave | Get all leave time offs, with optional filters: Person ID, Start Date, End Date, Modified After, Sort By, Order. |

Runn Trigger

The trigger node polls the Runn API and fires when records are created, updated, or deleted.

Resources: People, Projects, Clients, Assignments, Actuals, Contracts, Users, Teams

Events: Created, Updated, Deleted

Each trigger output includes a runnLink field with a direct link to the changed record in the Runn app.

Credentials

To use this node you need a Runn API key:

| Field | Description | | ----------- | ----------------------------------------------------------------------------------------- | | API Key | Your Runn API key. Generate one in Runn under Settings → API. |

The node authenticates using a Bearer token in the Authorization header.

Compatibility

• Requires Node.js v18 or higher
• Uses the runn-api-client npm package

Usage

1. Add the Runn node (or Runn Trigger) to your workflow
2. Configure your Runn API credentials
3. Select a resource (Actuals, Assignments, Clients, Contracts, People, Projects, or Time Offs)
4. Choose an operation
5. Fill in the required parameters
6. Execute the workflow

Tip: Use the Runn Trigger node to automatically start workflows when records change in Runn — no webhooks required, it uses polling.

Resources

• n8n community nodes documentation
• Runn API documentation
• How to generate a Runn API token
• GitHub repository

Attribution

This project is based on n8n-nodes-runn by Roman Rodomansky @ Ralabs, which is in turn based on the n8n community node starter template. Both are released under the MIT License. This package extends the original with additional resources, operations, and improvements.

Version history

1.0.9

• Wrapped raw HTTP errors in NodeApiError so status codes and response bodies surface correctly in the n8n UI
• Renamed resource options to singular: Actual, Assignment, Client, Contract, Person, Project, Time Off

1.0.8

• Replaced runn-api-client npm dependency with n8n's built-in httpRequestWithAuthentication helper — removes the external dependency that blocked n8n Cloud vetting
• Converted trigger node from setInterval-based polling to n8n's native polling: true + poll() pattern
• Added authenticate property to credentials so auth headers are injected automatically by n8n

1.0.7

• Added Time Offs resource with Create Leave (POST /time-offs/leave/) and Get All Leave (GET /time-offs/leave/) operations

1.0.6

• Added Contracts resource with Get All operation (GET /contracts/), supporting optional filters: Modified After, Sort By, and Order

1.0.5

• Added Delete operation to Assignments resource
• Fixed date timezone bug: dates no longer shift by one day for users in timezones ahead of UTC

1.0.4

• Added Create operation to Assignments resource (POST /assignments/) with required fields (Person ID, Project ID, Role ID, Start Date, End Date, Minutes Per Day) and optional fields (Billable, Include Non-Working Days, Note, Phase ID, Workstream ID)

1.0.3

• Added Assignments resource with Get All operation, supporting server-side filters (Person ID, Project ID, Role ID, Start Date, End Date, Modified After) and client-side Only Active filter

1.0.2

• Added Actuals resource with Create or Update, Delete, and Get All operations

1.0.1

• Added Team ID or Name field to the People > Create operation — accepts either a numeric ID or a team name (resolved automatically)
• Fixed credential test: corrected API base URL and added required headers so the green "Connection tested" badge now appears
• Fixed updatePerson: First Name, Last Name, and Email are no longer required fields (partial updates now work)
• Fixed trigger node: removed duplicate fields in trigger output
• Fixed error handling: all write operations now handle network errors safely
• Removed debug-level logging from production API calls

1.0.0

• Initial release
• People resource with Archive, Create, Delete, Get All, Get One, Unarchive, and Update operations
• Projects resource with Add Note, Archive, Create, Delete, Get All, Get One, Unarchive, and Update operations
• Clients resource with Archive, Create, Get All, Get One, Unarchive, and Update operations
• Runn Trigger node for polling-based event detection across all resources
• Bearer token authentication with credential test