@magnetcustomer/n8n-nodes-magnetcustomer
v2.1.6
Published
n8n community node for Magnet Customer CRM — automate leads, deals, contacts, tasks and more
Maintainers
Readme
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-magnetcustomerOr install via the n8n UI:
- Go to Settings > Community Nodes
- Search for
@magnetcustomer/n8n-nodes-magnetcustomer - 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
- Go to Credentials > New Credential > Magnet Customer API
- Enter your Subdomain (
subDomainAccount) — e.g.,mycompany(your URL ismycompany.magnetcustomer.com) - 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 test65 unit tests covering all resources, operations, and edge cases.
E2E Tests
npm run test:e2e105 end-to-end tests that run against a real Magnet Customer API instance via Docker.
E2E Setup
- Copy the config template:
cp e2e/config/e2e.config.example.json e2e/config/e2e.config.json - Fill in your credentials in
e2e/config/e2e.config.json - Start the E2E infrastructure:
npm run e2e:infra:start - 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 Migration Guide for details.
API Reference
Full API documentation is available at 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
