Actions77
- Accessory Actions
- Authentication Actions
- Backup & Restore Actions
- Config Editor Actions
- Platform Tool Actions
- Plugin Actions
- Server Actions
- Restart Server
- Restart Child Bridge
- Stop Child Bridge
- Start Child Bridge
- Get Pairing Info
- Reset Homebridge Accessory
- Reset Cached Accessories
- Get Cached Accessories
- Delete Cached Accessories
- Delete Cached Accessory
- Get Device Pairings
- Get Device Pairing
- Delete Device Pairing
- Get Unused Port
- Get Network Interfaces
- Get Bridge Network Interfaces
- Set Bridge Network Interfaces
- Setup Wizard Actions
- Status Actions
- User Actions
Overview
This node interacts with the Homebridge API, specifically supporting initial setup operations such as creating the first user in the system. The "Create First User" operation allows you to programmatically set up the very first administrative user for a Homebridge instance. This is particularly useful when automating the deployment or configuration of Homebridge environments where manual user creation is not desirable.
Practical examples include:
- Automating Homebridge server initialization with a predefined admin user.
- Integrating Homebridge setup into larger automation workflows that require user provisioning.
- Quickly setting up a new Homebridge instance without manual UI interaction.
Properties
| Name | Meaning |
|---|---|
| Access Token | Access token obtained from a prior login operation; can be entered manually if not connected to a Login node. |
| Name | Full name of the user to create. |
| Username | Username for the new user account. |
| Password | Password for the new user account. |
| Admin | Boolean flag indicating whether the user should have administrative privileges (true/false). |
Output
The node outputs JSON data representing the response from the Homebridge API after attempting to create the first user. This typically includes details about the created user or error information if the operation failed.
No binary data output is involved.
Dependencies
- Requires an active connection to a Homebridge server API endpoint.
- Needs an API authentication token (access token) either passed from a Login operation or manually provided.
- The node expects the Homebridge API URL and credentials to be configured properly in n8n credentials.
Troubleshooting
- Missing or invalid access token: If the access token is missing or incorrect, the API call will fail with an authentication error. Ensure the token is valid and correctly supplied.
- User already exists: Attempting to create the first user when one already exists may result in an error. Verify the state of the Homebridge instance before running this operation.
- Network or connectivity issues: Failure to reach the Homebridge API endpoint will cause errors. Check network settings and API URL configuration.
- Invalid input data: Required fields like username, password, and name must be provided; otherwise, the request will be rejected.
Links and References
- Homebridge Official Website
- Homebridge API Documentation (if available)
- n8n Documentation on Creating Custom Nodes