N8N Tools - Pipefy Integration

Complete Pipefy integration for N8N with advanced GraphQL API support, offering comprehensive card, pipe, database, and real-time webhook functionality.

🚀 Features

✅ Complete Pipefy Integration

• GraphQL API: Full support for Pipefy's modern GraphQL API
• Rate Limit Handling: Intelligent handling of 500 requests/30s limit
• Error Management: Comprehensive error handling with detailed messages
• Authentication: Secure Personal Access Token authentication

🎯 4 Specialized Nodes

🟠 N8N Tools - Pipefy Card (#FF5722)

Complete card management with advanced features:

• ✅ Create: New cards with custom fields, assignees, labels
• ✅ Update: Modify existing cards and field values
• ✅ Get: Retrieve single card with all details
• ✅ Get Many: Bulk card retrieval with pagination
• ✅ Search: Advanced search by title, assignee, labels
• ✅ Move Phase: Transfer cards between workflow phases
• ✅ Delete: Remove cards from pipes

🟡 N8N Tools - Pipefy Pipe (#E91E63)

Process and workflow management:

• ✅ Create/Update/Delete: Full pipe lifecycle management
• ✅ Get Details: Retrieve pipe configuration and statistics
• ✅ Manage Phases: Configure workflow stages
• ✅ Member Management: Add/remove pipe members
• ✅ Field Configuration: Custom field setup

🟣 N8N Tools - Pipefy Database (#9C27B0)

Structured data and table operations:

• ✅ Create/Update Records: Database record management
• ✅ Table Management: Create and configure tables
• ✅ Bulk Operations: Mass data import/export
• ✅ Query Records: Advanced data retrieval
• ✅ Schema Management: Field and structure configuration

🔵 N8N Tools - Pipefy Trigger (#673AB7)

Real-time event automation:

• ✅ Webhook Support: Instant event notifications
• ✅ Card Events: Create, update, phase change triggers
• ✅ Pipe Events: Process and configuration changes
• ✅ Custom Filtering: Event-specific trigger conditions
• ✅ Payload Transformation: Clean, structured event data

📦 Installation

# Install via N8N Community Nodes
npm install n8n-nodes-n8ntools-pipefy

# Or install globally
npm install -g n8n-nodes-n8ntools-pipefy

🔐 Configuration

1. Get Pipefy Personal Access Token

1. Go to https://app.pipefy.com/tokens
2. Click "Generate new token"
3. Add description (e.g., "N8N Integration")
4. Copy the generated token

2. Configure N8N Credentials

1. In N8N, go to Credentials
2. Add "N8N Tools - Pipefy API" credential
3. Paste your Personal Access Token
4. Test connection

🎯 Usage Examples

Create Card with Custom Fields

{
  "pipeId": "123456",
  "title": "New Customer Inquiry",
  "phaseId": "789012",
  "additionalFields": {
    "dueDate": "2025-01-15T10:00:00Z",
    "assigneeIds": "user123,user456",
    "fieldValues": [
      {
        "fieldId": "customer_email",
        "value": "customer@example.com"
      },
      {
        "fieldId": "priority",
        "value": "High"
      }
    ]
  }
}

Search Cards by Criteria

{
  "pipeId": "123456",
  "searchTitle": "urgent",
  "assigneeId": "user123",
  "labelId": "label456",
  "limit": 25
}

Move Card Through Workflow

{
  "cardId": "987654",
  "destinationPhaseId": "phase789"
}

🔧 Advanced Features

Batch Operations

• Bulk Card Creation: Create multiple cards in single operation
• Mass Updates: Update multiple cards simultaneously
• Batch Phase Movement: Move multiple cards between phases
• Bulk Delete: Remove multiple cards at once

Field Value Management

• Custom Field Types: Support for all Pipefy field types
• Rich Data: Handle attachments, dates, numbers, selections
• Validation: Automatic field validation and type checking
• Relationships: Manage card connections and dependencies

Error Handling

• Rate Limit Retry: Automatic retry on rate limit hit
• Detailed Errors: Clear error messages with context
• Fallback Options: Graceful degradation on failures
• Logging: Comprehensive operation logging

📊 API Rate Limits

Pipefy enforces the following limits:

• Per Request: 500 requests per 30 seconds
• Monthly Limits:
  • Starter: 20 calls
  • Business: 500 calls
  • Enterprise: 10,000 calls
  • Unlimited: Custom

🔒 Security & Best Practices

Authentication

• ✅ Bearer Token: Secure OAuth2 authentication
• ✅ Credential Storage: Encrypted token storage in N8N
• ✅ Access Control: Admin/Super Admin requirement
• ✅ Token Management: Easy token rotation support

Data Protection

• ✅ Field Validation: Input sanitization and validation
• ✅ Error Sanitization: No sensitive data in error messages
• ✅ Secure Transmission: HTTPS-only API communication
• ✅ Minimal Permissions: Request only necessary data

🎨 Node Color Hierarchy

Our nodes use a carefully designed color hierarchy:

• 🟠 Card (#FF5722): Primary operations - most frequently used
• 🟡 Pipe (#E91E63): Process management - configuration focused
• 🟣 Database (#9C27B0): Data operations - structured content
• 🔵 Trigger (#673AB7): Event handling - automation focused

🚀 Performance Optimization

GraphQL Efficiency

• Field Selection: Request only needed fields
• Batch Queries: Multiple operations in single request
• Pagination: Efficient large dataset handling
• Caching: Smart response caching where appropriate

Network Optimization

• Connection Reuse: HTTP connection pooling
• Compression: Gzip request/response compression
• Timeout Handling: Configurable request timeouts
• Retry Logic: Exponential backoff on failures

🛠️ Development & Support

Documentation

• Complete API Coverage: All Pipefy GraphQL operations
• Usage Examples: Real-world implementation samples
• Best Practices: Recommended patterns and approaches
• Troubleshooting: Common issues and solutions

Community Support

• GitHub Issues: Report bugs and feature requests
• Documentation: Complete guides and API reference
• Examples: Sample workflows and use cases
• Discord: Join our community

📄 License

MIT License - see LICENSE file for details.

🏆 Why Choose N8N Tools Pipefy?

✅ Complete Coverage: All major Pipefy operations supported
✅ Production Ready: Battle-tested with comprehensive error handling
✅ Performance Optimized: Efficient GraphQL queries and caching
✅ Developer Friendly: Clear documentation and examples
✅ Community Driven: Open source with active maintenance
✅ Enterprise Grade: Secure, scalable, and reliable

---

Made with ❤️ by the N8N Tools Community

Transform your Pipefy workflows with the power of N8N automation!