Description
!npm version
!License
!Downloads
Magnet Customer — n8n Community Node
n8n community node for Magnet Customer CRM. Automate leads, deals, contacts, tasks, and more in your n8n workflows.
Installation
npm install @magnetcustomer/n8n-nodes-magnetcustomer
Or install via the n8n UI:
1. Go to Settings > Community Nodes
2. Search for @magnetcustomer/n8n-nodes-magnetcustomer
3. Click Install
Authentication
Two authentication methods are supported:
- API Token — Generate in Settings > API within your Magnet Customer account
- OAuth2 — Configure OAuth2 credentials for server-to-server flows
Configuration
1. Go to Credentials > New Credential > Magnet Customer API
2. Enter your Subdomain (subDomainAccount) — e.g., mycompany (your URL is mycompany.magnetcustomer.com)
3. Enter your API Token
Available Resources
| Resource | Create | Get | Get Many | Update | Delete | Search |
|———-|:——:|:—:|:——–:|:——:|:——:|:——:|
| Customer | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Lead | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Prospect | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Deal | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Task | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Organization | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Staff | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Pipeline | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Workspace | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Custom Field | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Custom Field Block | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Custom Field Type | — | — | ✅ | — | — | ✅ |
| Ticket | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Meeting | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Meeting Room | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Meeting Type | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Treatment | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Treatment Type | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
> Custom Field Type is read-only (Get Many + Search only).
Testing
Unit Tests
npm test
65 unit tests covering all resources, operations, and edge cases.
E2E Tests
npm run test:e2e
105 end-to-end tests that run against a real Magnet Customer API instance via Docker.
#### E2E Setup
1. Copy the config template:
cp e2e/config/e2e.config.example.json e2e/config/e2e.config.json
2. Fill in your credentials in e2e/config/e2e.config.json
3. Start the E2E infrastructure:
npm run e2e:infra:start
4. Run E2E tests:
npm run test:e2e
Migration from 1.x
Version 2.0 introduces changes for full V2 API compatibility:
| Aspect | v1.x | v2.0 |
|——–|——|——|
| Create endpoints | /import/leads, /import/contacts, etc. | /leads, /contacts, etc. |
| Source tracking | Header api: 'n8n' | Body field source: 'n8n' |
| Platform support | V1 + V2 | V2 only |
See the full apireference.magnetcustomer.com.
Compatibility
Tested on n8n version 1.62.0+
Contributing
See CONTRIBUTING.md for development setup and guidelines.
Changelog
See CHANGELOG.md for a detailed history of changes.
License
MIT — Magnet Customer
