🧩 n8n-nodes-salamcrm

Community Node for integrating SalamCRM with n8n.io

Bring the power of SalamCRM into your n8n workflows.
Easily connect and automate appointments, leads, invoices, products, and customers without writing a single line of code!

🚀 Overview

This n8n Community Node provides full integration with SalamCRM REST API, enabling you to:

• 🔁 Create, Read, Update, and Delete (CRUD) records
• ⚙️ Work with entities like Appointments, Customers, Leads, Invoices, Products, and more
• 🔐 Authenticate securely with Basic Auth
• ⚡ Automate CRM workflows such as:
  • Scheduling follow-ups
  • Generating invoices
  • Syncing leads and forms
  • Sending reminders and notifications

📦 Entities Supported

| Entity | Supported Operations | |--------|-----------------------| | Appointment | Get All, Get by ID, Create, Update, Delete, Merge, Set Status, Calendar, Operators | | Customer | Get All, Get by ID, Create, Update, Delete, Add Note, Manage Tags | | Lead | Get All, Get by ID, Create, Update, Delete, Set Status, Bulk Set Status | | Invoice | Get All, Get by ID, Create, Update, Delete, Get New Number, PDF/Print Link | | Product | Get All, Get by ID, Create, Update, Delete, Change Stock, Import Excel | | Department | Get All, Get by ID, Create, Update, Delete | | Form | Get All, Get by ID, Create, Update, Delete | | Provider | Get All, Get by ID, Create, Update, Delete | | Turn | Get All, Get by ID, Create, Update, Delete | | Worktime | Get All, Get by ID, Create, Update, Delete | | Manufacturer | Get All, Get by ID, Create, Update, Delete | | Categorie | Get All, Get by ID, Create, Update, Delete | | User | Get All, Get Operators, Get by ID |

🧠 Example Use Cases

| Scenario | Description | |-----------|-------------| | Sync appointments | Fetch daily appointments from SalamCRM and send reminders via Telegram | | Auto-create leads | Automatically create a new lead when a website form is submitted | | Generate invoices | Trigger invoice creation after successful payment confirmation | | Update CRM | Sync customer updates between SalamCRM and Google Sheets |

🧰 Installation

📦 Option 1 — From npm (recommended)

npm install n8n-nodes-salamcrm

🧑‍💻 Option 2 — Manual installation for local testing

git clone https://github.com/yourusername/n8n-nodes-salamcrm.git
cd n8n-nodes-salamcrm
npm install
npm run build

Then copy it to your n8n custom extensions folder:

macOS / Linux:

export N8N_CUSTOM_EXTENSIONS="$HOME/.n8n/custom"
mkdir -p "$N8N_CUSTOM_EXTENSIONS/n8n-nodes-salamcrm"
cp -r package.json dist credentials nodes "$N8N_CUSTOM_EXTENSIONS/n8n-nodes-salamcrm"
n8n start

Windows (PowerShell):

$env:N8N_CUSTOM_EXTENSIONS="$env:USERPROFILE\.n8n\custom"
New-Item -ItemType Directory -Force "$env:N8N_CUSTOM_EXTENSIONS\n8n-nodes-salamcrm"
Copy-Item package.json,credentials,nodes,dist -Destination "$env:N8N_CUSTOM_EXTENSIONS\n8n-nodes-salamcrm" -Recurse

After restarting n8n, go to: Settings → Community Nodes → Enable

🔐 Credentials Setup

1. In n8n, go to Credentials → New Credential → SalamCRM API

2. Fill in your API connection details:

   • Base URL: https://yourdomain.salamcrm.com
   • Username: Your SalamCRM username
   • Password: Your SalamCRM password

3. Click Test and Save

🧩 Usage

After installation and credential setup:

1. Add a new node → Search for SalamCRM
2. Choose your Resource (e.g., Appointment, Lead, Customer)
3. Choose Operation (e.g., GetAll, Create, Update)
4. Map input parameters
5. Execute the node ✅

🧪 Example Workflow

{
  "nodes": [
    {
      "parameters": {
        "resource": "appointment",
        "operation": "appointments_Getall",
        "take": 5
      },
      "name": "SalamCRM - Get Appointments",
      "type": "n8n-nodes-salamcrm.SalamCrm",
      "typeVersion": 1,
      "credentials": {
        "salamCrmApi": "SalamCRM Credential"
      }
    }
  ]
}

🧱 Development

If you want to modify or extend this node:

npm install
npm run build

You can add your own entities or operations inside nodes/SalamCrm/descriptions/ folder and register them in SalamCrm.node.ts.

🧾 Folder Structure

n8n-nodes-salamcrm/
├─ package.json
├─ tsconfig.json
├─ credentials/
│  └─ SalamCrmApi.credentials.ts
└─ nodes/
   └─ SalamCrm/
      ├─ SalamCrm.node.ts
      ├─ GenericFunctions.ts
      ├─ salamcrm.svg
      └─ descriptions/
         ├─ Appointment.description.ts
         ├─ Customer.description.ts
         ├─ Lead.description.ts
         ├─ Invoice.description.ts
         └─ ...

📄 License

This project is licensed under the MIT License. See LICENSE for more details.

💬 Contributing

Contributions are welcome! If you’d like to add more SalamCRM endpoints or improve documentation:

1. Fork the repo
2. Create a feature branch
3. Submit a Pull Request

Your contributions help improve automation for everyone 💙

🧩 Support

For support or feature requests:

• Create an issue here → GitHub Issues
• Or reach out via SalamCRM developer channel if you’re part of the internal team.

⭐ Acknowledgments

Built with ❤️ using:

• n8n Community Nodes SDK
• SalamCRM API

© 2025 Ershad — MIT Licensed