n8n-nodes-perfexcrm-api

n8n-nodes-perfexcrm-api

This is an n8n community node that provides comprehensive integration with PerfexCRM API, allowing you to manage Calendar Events, Customers, Items, Leads, Subscriptions, Tasks, and Tickets with full CRUD operations directly from your n8n workflows.

n8n is a fair-code licensed workflow automation platform.

📋 Prerequisites - PerfexCRM API Module

This n8n node requires the PerfexCRM API module to be installed on your PerfexCRM instance.

👉 Purchase the PerfexCRM API Module

The module provides:

• RESTful API endpoints for PerfexCRM entities
• API key authentication
• Rate limiting and security features
• Comprehensive API documentation

🚀 Why Choose This Node?

✅ Complete Resource Management

• 7 Resources Implemented: Calendar Events, Customers, Items, Leads, Subscriptions, Tasks, Tickets
• Full CRUD operations for each resource
• Support for all fields including custom fields
• Proper form-encoded data handling where required
• Over 30 operations fully implemented and tested

✅ Better Implementation

• Most comprehensive PerfexCRM integration available
• Better error handling and data validation
• TypeScript implementation with full type safety
• Follows n8n community standards
• Date formatting for Calendar Events

✅ Community Focused

• Open source with active development
• Clear documentation and examples
• Regular updates and bug fixes

Table of Contents

• Installation
• Operations
• Credentials
• Usage
• Examples
• Compatibility
• Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

For n8n cloud users, this node will be available after verification.

For self-hosted n8n users:

• Go to Settings > Community Nodes
• Select Install
• Enter n8n-nodes-perfexcrm-api
• Agree to the risks of using community nodes (see note below)
• Select Install

After installation, the PerfexCRM node will be available in your n8n editor.

Operations

The PerfexCRM node supports the following resources and operations:

Calendar Event Operations (5 operations)

• Create: Create a new calendar event with date/time
• Delete: Remove an existing calendar event by ID
• Get: Retrieve a specific calendar event by ID
• Get Many: Fetch all calendar events
• Update: Modify an existing calendar event

Customer Operations (5 operations)

• Create: Create a new customer
• Delete: Remove an existing customer by ID
• Get: Retrieve a specific customer by ID
• Get All: Fetch all customers
• Update: Modify an existing customer

Item Operations (2 operations)

• Get: Retrieve a specific item by ID
• Search: Search for items using search terms

Lead Operations (6 operations)

• Create: Create a new lead with all required and optional fields
• Delete: Remove an existing lead by ID
• Get: Retrieve a specific lead by ID
• Get All: Fetch all leads from your PerfexCRM instance
• Search: Search for leads using search terms
• Update: Modify an existing lead's information

Subscription Operations (5 operations)

• Create: Create a new subscription
• Delete: Remove an existing subscription by ID
• Get: Retrieve a specific subscription by ID
• Get All: Fetch all subscriptions
• Update: Modify an existing subscription

Task Operations (5 operations)

• Create: Create a new task
• Delete: Remove an existing task by ID
• Get: Retrieve a specific task by ID
• Search: Search for tasks using search terms
• Update: Modify an existing task

Ticket Operations (5 operations)

• Create: Create a new ticket
• Delete: Remove an existing ticket by ID
• Get: Retrieve a specific ticket by ID
• Search: Search for tickets using search terms
• Update: Modify an existing ticket

Credentials

To use this node, you need to configure the PerfexCRM API credentials:

Required Fields

• Base URL: Your PerfexCRM installation URL (e.g., https://yourcrm.com)
• API Token: Your PerfexCRM API authentication token

How to Get Your API Token

• Log into your PerfexCRM instance
• Go to Setup > API or API > API Management
• Generate or copy your API token
• Ensure API access is enabled for your user role

Usage

Basic Workflow Example

• Add the PerfexCRM node to your workflow
• Select the desired Resource (Calendar Event, Customer, Item, Lead, Subscription, Task, or Ticket)
• Choose your desired operation (Create, Get, Update, etc.)
• Configure the required parameters
• Connect your PerfexCRM API credentials

Create Calendar Event Example

To create a new calendar event:

• Set Resource to Calendar Event
• Set Operation to Create
• Fill in the required fields:
  • Title: Event title
  • Start: Event start date/time (automatically formatted)
  • Reminder Before Type: minutes/hours/days
  • Reminder Before: Numeric value
  • User ID: Assigned user
  • Is Start Notified: Yes/No
  • Public: Yes/No
• Optionally, add description and color

Create Lead Example

To create a new lead:

• Set Operation to Create
• Fill in the required fields:
  • Name: Lead's name
  • Source: Lead source
  • Status: Lead status
  • Assigned: User ID to assign the lead to
• Optionally, add additional fields like email, phone, company, etc.

Search Leads Example

To search for leads:

• Set Resource to Lead
• Set Operation to Search
• Enter your Search Term
• The node will return matching leads

Examples

Complete Calendar Event Management Workflow

{
  "nodes": [
    {
      "name": "Create Calendar Event",
      "type": "n8n-nodes-perfexcrm-api.perfexCrm",
      "parameters": {
        "resource": "calendarEvent",
        "operation": "create",
        "title": "Team Meeting",
        "start": "2025-10-27T10:00:00",
        "reminder_before_type": "minutes",
        "reminder_before": 30,
        "userid": "1",
        "isstartnotified": "0",
        "public": "1",
        "additionalFields": {
          "description": "Discuss Q4 goals",
          "color": "#03a9f4"
        }
      }
    }
  ]
}

Complete Lead Management Workflow

{
  "nodes": [
    {
      "name": "Create Lead",
      "type": "n8n-nodes-perfexcrm-api.perfexCrm",
      "parameters": {
        "resource": "lead",
        "operation": "create",
        "name": "John Doe",
        "source": "1",
        "status": "1",
        "assigned": "1",
        "additionalFields": {
          "email": "[e-mail]",
          "phonenumber": "[phone]",
          "company": "Acme Corp"
        }
      }
    }
  ]
}

Integration with Other Services

This node works great with:

• Webhook nodes for lead capture from forms
• Email nodes for lead follow-up automation
• Spreadsheet nodes for lead data import/export
• HTTP Request nodes for additional PerfexCRM API calls

Compatibility

• n8n version: 1.0.0 and above
• PerfexCRM version: Compatible with PerfexCRM API v1
• Node.js version: 18.0.0 and above

Known Limitations

• Requires valid API token with appropriate permissions
• File uploads not yet supported
• Some advanced PerfexCRM features may require additional API endpoints

Development

Building the Node

npm install
npm run build

Running Tests

npm run dev

Linting

npm run lint
npm run lint:fix

Contributing

Found a bug or want to add a feature? Contributions are welcome!

• Fork the repository
• Create a feature branch
• Make your changes
• Add tests if applicable
• Submit a pull request

Support

• GitHub Issues - Bug reports and feature requests
• n8n Community Forum - General n8n discussions
• PerfexCRM API Documentation - Official PerfexCRM API Rest documentation

Changelog

0.1.0

• Initial release
• 7 Resources implemented: Calendar Events, Customers, Items, Leads, Subscriptions, Tasks, Tickets
• Over 30 operations available
• Full CRUD operations for most resources
• API token authentication
• Search functionality for applicable resources
• Comprehensive error handling
• Date formatting for Calendar Events

License

MIT

Resources

• n8n community nodes documentation
• PerfexCRM API Documentation - Official PerfexCRM API Rest documentation
• PerfexCRM API Module - Purchase the required API module
• n8n Node Development Guide

Disclaimer: This is a community node and is not officially supported by n8n or PerfexCRM. Use at your own risk and ensure you comply with your organization's security policies.