# 🧩 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