n8n-nodes-nifty

This is an n8n community node that lets you integrate Nifty project management into your n8n workflows.

Nifty is a collaborative project management platform that brings teams together to deliver successful projects. This integration allows you to automate your project workflows with n8n.

n8n is a fair-code licensed workflow automation platform.

🚀 Features

Resources

• Projects: List and retrieve project information
• Tasks: Full CRUD operations with advanced filtering
• Webhooks: Set up event-driven automations

Task Operations

• ✅ Create - Create new tasks with all fields (name, description, due date, priority, assignees, labels, etc.)
• 📄 Get - Retrieve a single task by ID
• 📋 Get Many - List all tasks with powerful filters (status, priority, assignee, milestone, date range, search)
• ✏️ Update - Update task properties
• ✓ Complete - Mark tasks as complete

Advanced Features

• 🔄 Dynamic Field Loading: Project, member, milestone, and label dropdowns load automatically
• 🎯 Resource Locator: Select projects by list, ID, or name
• 🔍 Powerful Filtering: Filter tasks by status, priority, assignee, milestone, dates, and search queries
• 📊 Pagination Support: Automatically handles large result sets
• 🪝 Webhooks: Set up event-driven triggers for real-time automation

📦 Installation

Community Nodes (Recommended)

1. Go to Settings > Community Nodes in your n8n instance
2. Select Install
3. Enter n8n-nodes-nifty in the search bar
4. Click Install

Manual Installation

To get started install the package in your n8n root directory:

npm install n8n-nodes-nifty

For Docker-based n8n:

docker exec -it n8n npm install n8n-nodes-nifty

🔑 Credentials

This node uses OAuth2 authentication following n8n's standard credential pattern.

OAuth2 Setup

1. Create an OAuth2 app in Nifty:

   • Go to Profile → App Center → Integrate with API
   • Click "+ Create a new App"
   • Fill in app details and redirect URL (see detailed guide below)

2. Configure n8n credentials:

   • In n8n, go to Credentials → Add Credential
   • Search for "Nifty OAuth2 API"
   • Enter your Client ID and Client Secret
   • Configure scopes based on your needs
   • Click "Connect my account" and authorize

3. Automatic token refresh:

   • n8n automatically handles token refresh
   • No manual intervention needed

📖 Complete OAuth2 Setup Guide: See OAUTH2-SETUP.md for detailed step-by-step instructions, troubleshooting, and best practices.

💡 Usage Examples

Example 1: Create Task When Form Submitted

Webhook Trigger → Nifty (Create Task)

Automatically create tasks in Nifty when forms are submitted on your website.

Example 2: Sync Completed Tasks to Google Sheets

Nifty Webhook (task.completed) → Google Sheets (Append Row)

Log all completed tasks to a spreadsheet for reporting.

Example 3: Daily Task Digest

Schedule Trigger (Daily) → Nifty (Get Many Tasks) → Filter (Due Today) → Email

Get a daily email with all tasks due today.

Example 4: Multi-Project Task Report

Schedule Trigger → Nifty (Get Many Tasks) → Filter by Status → Aggregate → Slack

Send weekly reports of task progress across all projects.

📖 Operations

Project

• Get: Retrieve a single project by ID
• Get Many: List all projects with status filters

Task

• Create: Create a new task with full field support
  • Required: Project, Name
  • Optional: Description, Due Date, Priority, Status, Assignees, Labels, Milestone, List
• Get: Retrieve a single task by ID
• Get Many: List tasks with filters
  • Filters: Project, Status, Priority, Assignee, Milestone, Date Range, Search Query
• Update: Update task fields
• Complete: Mark a task as complete

Webhook

• Create: Create a webhook for event-driven automation
  • Events: task.created, task.updated, task.completed, task.deleted, project.created, etc.
• Get Many: List all webhooks
• Delete: Remove a webhook

🔧 Development

Building the Node

npm install
npm run build

Testing Locally

npm run dev
# Then open n8n at http://localhost:5678

Linting

npm run lint
npm run lintfix

📚 Resources

• n8n Documentation
• Nifty API Documentation
• Nifty OpenAPI Spec

🐛 Known Issues & Limitations

• Rate Limits: Nifty API has rate limits (200 GET/min, 50 POST/min, 50 PUT/min, 10 DELETE/min)
• Pagination: The node handles pagination automatically, but very large result sets may take time
• Custom Fields: Currently not supported (coming in future version)

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 Version History

0.1.0 - Initial Release

• ✅ Project operations (Get, Get Many)
• ✅ Task operations (Create, Get, Get Many, Update, Complete)
• ✅ Webhook operations (Create, Get Many, Delete)
• ✅ Dynamic field loading for projects, members, milestones, labels, lists
• ✅ Advanced task filtering
• ✅ Resource locator support

📄 License

MIT

💬 Support

For support, please:

1. Check the n8n community forum
2. Open an issue on GitHub
3. Refer to Nifty's documentation

🙏 Acknowledgments

• Built with n8n
• Integrates with Nifty PM
• Based on n8n-nodes-starter