Description

n8n-nodes-scalepad

This is an n8n community node for ScalePad. It provides integration with both the Core API and Lifecycle Manager API for MSPs.

Installation | Operations | Credentials | Usage | Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Nodes (Recommended)

1. Go to Settings > Community Nodes
2. Select Install
3. Enter @joshuanode/n8n-nodes-scalepad in Enter npm package name
4. Agree to the risks of using community nodes
5. Select Install

After installation, restart n8n to load the node.

Manual Installation

npm install @joshuanode/n8n-nodes-scalepad

Operations

This node provides access to both ScalePad Core API and Lifecycle Manager API resources.

Core API Resources

| Resource | Operations |
|———-|————|
| Client | Get, Get Many |
| Contact | Get, Get Many |
| Contract (Core) | Get, Get Many |
| Hardware Asset | Get, Get Many |
| Member | Get, Get Many |
| Opportunity | Get, Get Many |
| SaaS | Get, Get Many |
| Ticket | Get, Get Many |

Lifecycle Manager Resources

| Resource | Operations |
|———-|————|
| Action Item | Create, Get, Get Many, Update, Delete, Toggle Completion |
| Assessment | Create, Get, Get Many, Update, Delete, Update Completion, Evaluate |
| Assessment Template | Get Many |
| Contract (Lifecycle) | Create, Get, Get Many, Update, Delete |
| Goal | Create, Get, Get Many, Update, Delete, Update Status, Update Schedule, Link/Unlink Meetings, Link/Unlink Initiatives |
| Hardware Lifecycle | Get Many |
| Initiative | Create, Get, Get Many, Update, Delete, Update Status/Schedule/Priority/Budget, Link/Unlink Meetings, Link/Unlink Goals, Link/Unlink Action Items |
| Meeting | Create, Get, Get Many, Update, Delete, Update Completion, Add/Remove Attendees, Link/Unlink Initiatives, Link/Unlink Goals, Link/Unlink Action Items |
| Note | Create, Get, Get Many, Update, Toggle Archive |

Features

• Full CRUD operations for Lifecycle Manager resources
• Automatic cursor-based pagination (up to 200 records per page)
• Filtering support per resource
• Sorting support (clients)
• Rate limit error handling (50 req/5sec)
• Production and Sandbox environment support
• Link/unlink relationships between meetings, initiatives, goals, and action items

Credentials

API Key Authentication

Requirements:

• ScalePad Partner account
• Administrator permissions

Setup:

1. Sign in to ScalePad Hub
2. Navigate to API (BETA) in the top menu
3. Click + Generate to create a new API key
4. Copy the API key immediately (it won’t be shown again)

In n8n:

• API Key: Your generated API key
• Environment: Production or Sandbox

The same API key provides access to both Core API and Lifecycle Manager API.

Usage

Get All Clients

Resource: Client
Operation: Get Many
Return All: true

Create a Meeting

Resource: Meeting
Operation: Create
Client ID: 
Title: Quarterly Business Review
Scheduled At: 2024-03-15T10:00:00Z

Get Action Items for a Client

Resource: Action Item
Operation: Get Many
Filters:
  Client ID: 
  Is Completed: false

Link an Initiative to a Meeting

Resource: Meeting
Operation: Link Initiative
Meeting ID: 
Initiative ID: 

API Limits

| Limit | Value |
|——-|——-|
| Rate limit | 50 requests per 5 seconds |
| Page size | Up to 200 records per request |
| Pagination | Cursor-based (automatic with “Return All”) |

Error Handling

| Code | Meaning | Resolution |
|——|———|————|
| 401 | Authentication failed | Check API key validity |
| 404 | Resource not found | Verify resource ID |
| 429 | Rate limit exceeded | Reduce request frequency |

Resources

• ScalePad API Documentation
• n8n Community Nodes Documentation

Contributing

Contributions welcome. Open an issue or submit a pull request on GitHub.

License

MIT

Author

Joshua Smith