Overview
This n8n node, Toolzz List All Users Institution, retrieves a list of all users from an institution using the Toolzz API. It is designed to connect to different environments (Production, Homologation, Release) and requires an access token for authentication. This node is useful in scenarios where you need to synchronize user data from Toolzz with other systems, automate reporting, or trigger workflows based on user information.
Practical examples:
- Syncing Toolzz users into a CRM or email marketing tool.
- Generating reports of all users in an institution.
- Triggering notifications or actions when new users are detected.
Properties
| Name | Type | Meaning |
|---|---|---|
| AccessToken | String | The bearer token used for authenticating requests to the Toolzz API. |
| Ambiente | Options | Selects the environment (Prod, Homol, Release) to which the API request will be sent. |
Output
The node outputs a JSON array containing user objects as returned by the Toolzz API endpoint /api/users. Each item in the output array represents a user from the institution. The exact structure of each user object depends on the Toolzz API but typically includes fields such as user ID, name, email, etc.
Example output:
[
{
"id": 123,
"name": "Jane Doe",
"email": "jane.doe@example.com"
// ...other user fields
},
{
"id": 124,
"name": "John Smith",
"email": "john.smith@example.com"
// ...other user fields
}
]
Dependencies
- External Service: Requires access to the Toolzz API.
- API Key: A valid AccessToken (bearer token) is required.
- n8n Configuration: No special configuration needed beyond standard HTTP connectivity.
Troubleshooting
Common issues:
- Invalid AccessToken: If the provided token is invalid or expired, the API will return an authentication error. Ensure your token is correct and has not expired.
- Incorrect Ambiente selection: Choosing the wrong environment may result in connection errors or unexpected data. Double-check the selected environment matches your intended use.
- Network Issues: If n8n cannot reach the Toolzz API endpoint, check your network/firewall settings.
Common error messages:
401 Unauthorized: Indicates an invalid or missing AccessToken. Obtain a new token and update the node property.404 Not Found: The API endpoint may be incorrect or unavailable in the selected environment.5xx Server Error: The Toolzz API service may be down or experiencing issues; try again later.