n8n community node for PAL Gate API - manage users, places, devices, and organizations. Delete user operation fully working (v1.0.28+) with automatic phone formatting and type handling.
npm install n8n-nodes-palgatebash
npm install n8n-nodes-palgate
`
Or install via n8n Community Nodes settings in your n8n instance.
Supported Operations
$3
| Resource | Operation | Status | Description |
|----------|-----------|--------|-------------|
| Auth | Test Connection | ✅ Working | Verify credentials and connection to PAL Gate (uses minimal API call) |
| Places | Get All | ✅ Working | Get hierarchical tree of places |
| Places | Get One | ✅ Working | Get details of a specific place |
| Users | Get All | ✅ Working | Get all users in a place |
| Users | Add | ✅ Working | Add a new user to a place |
| Users | Update | ✅ Working | Update user information |
| Groups | Get All | ✅ Working | Get groups for a place |
| Devices | Get Info | ✅ Working | Get device information |
$3
| Resource | Operation | Status | Notes |
|----------|-----------|--------|-------|
| Users | Delete | ✅ Working | Fixed in v1.0.28 - handles both string and number phone formats |
| Devices | Open Gate | ⚠️ Use carefully | Triggers physical gate operation |
$3
| Resource | Operation | Status | Notes |
|----------|-----------|--------|-------|
| Vehicles | All Operations | ❌ Not supported | API endpoints not available - may be added in future updates |
Configuration
$3
The node requires PAL Gate API credentials:
- Username/Email: Your PAL Gate account email
- Password: Your PAL Gate account password
- API URL: https://portal.pal-es.com (default, automatically configured)
$3
You can verify your credentials and connection in two ways:
1. From the node: Add a PAL Gate node → choose Resource: Auth → Operation: Test Connection. Run the node; if it succeeds, credentials and connection are valid.
2. When saving credentials: In the credential dialog, use the Test / Verify button (if shown by your n8n version) to validate the connection before saving.
$3
- Place ID: Found in PAL Gate portal URL or settings (format: UUID)
- Device ID: For device operations, found in device settings
API Endpoints
$3
`
Authentication:
POST /api1/user/login1
Places:
GET /api1/places-tree
GET /api1/place/{placeId}
Users:
GET /api1/place/{placeId}/users
POST /api1/place/{placeId}/user
DELETE /api1/place/{placeId}/users
Groups:
GET /api1/place/{placeId}/groups
Devices:
GET /api1/device/{deviceId}
`
Error Handling
The node includes comprehensive error handling:
- Input Validation: Phone numbers, required fields, format checks
- Clear Error Messages: Context-aware error messages with helpful hints
- API Error Translation: Converts API errors to user-friendly messages
- Status Code Handling: Specific messages for common HTTP status codes
$3
- 400 Bad Request: "Bad request. Please check your input parameters."
- 401 Unauthorized: "Authentication failed. Please check your credentials."
- 403 Forbidden: "Access forbidden. You may not have permission for this operation."
- 404 Not Found: "Resource not found. Please verify the resource exists."
- 409 Conflict: "Conflict. The resource may already exist."
- 500+ Server Error: "Server error. Please try again later or contact support."
Safety Features
$3
Delete operations include multiple safety layers:
1. Phone Number Validation: Required, format check, non-empty validation
2. Type Handling: Accepts both string and number types (fixed in v1.0.28)
3. Automatic Formatting: Converts phone numbers to 972XXXXXXXXX format
4. Empty Array Prevention: Prevents sending empty phones arrays
5. Detailed Logging: Full audit trail of all delete operations
6. Warning Messages: Critical warnings about API behavior
✅ Fixed in v1.0.28: Delete operation now correctly handles phone numbers passed as numbers (from n8n expressions like 972{{ $json.M_phone }}).
$3
- Phone Validation: Prevents empty phone numbers (API would generate random IDs)
- Required Field Checks: Validates all required fields before sending
- Format Validation: Ensures data is in correct format
Usage Examples
$3
1. Select resource: User
2. Select operation: Add
3. Enter Place ID
4. Enter Phone number (required)
5. Enter First Name (required)
6. Enter Last Name (required)
7. Optionally add Cars
$3
1. Select resource: User
2. Select operation: Find or Get Many
3. Enter Place ID
4. Optionally add filter (for Find operation)
$3
1. Select resource: User
2. Select operation: Update or Update By Phone
3. Enter Place ID
4. Enter Phone number
5. Update desired fields
Known Limitations
$3
1. Vehicle Operations: Vehicle endpoints return 404. This is an API limitation, not a node issue.
2. Delete Operation: ✅ Fixed in v1.0.28 - now handles both string and number phone formats correctly.
3. Empty Phone Numbers: API accepts empty phone numbers and generates random IDs. Node validates to prevent this.
$3
- Vehicles: Currently not supported by API. May be added in future API updates.
- Delete Verification: Always check user count before and after delete operations.
Testing
The node has been tested against the live PAL Gate API. Run the test suite locally for detailed results (see Development below).
Troubleshooting
$3
Error 4101: "Check delete number list"
- Solution: Update to v1.0.28 or later
- Cause: Phone number type handling (fixed in v1.0.28)
Other Delete Issues:
- Verify phone number format
- Check n8n execution logs for validation messages
- Ensure place ID is correct
Support
$3
For issues with this n8n node:
- Open an issue on GitHub
- Check existing issues and documentation
$3
For PAL Gate API issues:
- Contact PAL Gate support
- Check PAL Gate API documentation
Development
$3
`bash
npm run build
`
$3
`bash
node test/automated-tests.js
`
$3
`bash
npm run lint
``