Overview
This node retrieves user information from the Toolzz API based on either an email address or a CPF (Cadastro de Pessoas Físicas, Brazilian individual taxpayer registry identification). It is useful in scenarios where you need to look up user details for automation workflows, such as verifying user identities, fetching user profiles, or integrating Toolzz user data with other systems.
Practical examples:
- Automatically enrich CRM records with user info from Toolzz using their email.
- Validate if a user exists in Toolzz by CPF before proceeding with onboarding steps.
- Fetch and display user profile data in custom dashboards.
Properties
| Name | Type | Meaning |
|---|---|---|
| AccessToken | String | The access token required for authenticating requests to the Toolzz API. |
| Ambiente | Options | Selects the environment (currently only "Prod" is available; sets the API base URL). |
| Filtrar por | Options | Determines the filter type: "Email" or "Cpf" (used to specify how to search for users). |
| Valor Para Fitrar | String | The value to filter by (either the user's email or CPF, depending on the selected filter). |
Output
The node outputs a JSON object containing the user information returned by the Toolzz API. The structure of this output depends on the API response, but typically includes user profile fields such as name, email, CPF, and other relevant attributes.
Example output:
[
{
"id": "12345",
"name": "João Silva",
"email": "joao.silva@example.com",
"cpf": "123.456.789-00",
// ...other user fields
}
]
Note: The actual fields may vary according to the Toolzz API.
Dependencies
- Toolzz API: Requires a valid access token for authentication.
- n8n HTTP Request Helper: Utilizes n8n's built-in request helper for making API calls.
Troubleshooting
Invalid Access Token:
If the access token is missing or invalid, the API will likely return an authentication error (e.g., 401 Unauthorized). Ensure that the provided token is correct and has not expired.Incorrect Filter Value:
If the "Valor Para Fitrar" does not match any user, the API may return an empty result or a not found error. Double-check the input value and filter type.API Endpoint Unreachable:
If the environment URL is incorrect or the Toolzz API is down, you may receive connection errors. Verify network connectivity and the selected environment.Common Error Messages:
401 Unauthorized: Check your AccessToken.400 Bad Request: Ensure all required parameters are filled and correctly formatted.404 Not Found: No user matches the provided filter value.