Toolzz Create User v3 icon

Toolzz Create User v3

Create User Toolzz API v3

Overview

This n8n node, Toolzz Create User v3, is designed to create a new user in the Toolzz platform via its API (version 3). It allows you to specify user details such as name, email, CPF, and associated school IDs, and sends this information to the selected Toolzz environment (Production, Homologation, or Release) using an access token for authentication.

Common scenarios:

  • Automating onboarding of users into the Toolzz system from other platforms.
  • Integrating with HR or school management systems to synchronize user data.
  • Bulk creation of users by iterating over input data in n8n workflows.

Practical example:
You could use this node in a workflow that triggers when a new student is added to your database, automatically creating their account in Toolzz and assigning them to one or more schools.

Properties

Name Type Meaning
Ambiente options Selects the target Toolzz environment (Prod, Homol, Release) for the API request.
AccessToken string The bearer token used for authenticating requests to the Toolzz API.
Nome string The full name of the user to be created.
Email string The email address of the user to be created.
Escola ID string Comma-separated list of school IDs to associate with the user.
Cpf string The CPF (Cadastro de Pessoas Físicas, Brazilian individual taxpayer registry) of the user.

Output

The node outputs the JSON response received from the Toolzz API after attempting to create the user. The structure of this output depends on the API's response, but typically includes fields such as:

{
  "id": "string",
  "name": "string",
  "email": "string",
  "schools": ["string", ...],
  // ...other user-related fields returned by the API
}
  • If the API returns an error, the node will throw an error rather than outputting JSON.

Dependencies

  • External Service: Requires access to the Toolzz API (v3).
  • API Key: A valid AccessToken (bearer token) must be provided.
  • Network: The n8n instance must be able to reach the selected Toolzz environment URL.

Troubleshooting

Common issues:

  • Invalid AccessToken: If the access token is missing or invalid, the API will reject the request with an authentication error.
  • Malformed School IDs: If the "Escola ID" field contains improperly formatted values (e.g., extra spaces, empty strings), the API may return a validation error.
  • Missing Required Fields: Omitting required fields like "Nome" or "Email" will result in an error from the API.

Error messages:

  • 401 Unauthorized: Check that the AccessToken is correct and has not expired.
  • 400 Bad Request: Ensure all required fields are filled and properly formatted.
  • Network Error: Verify that the selected environment URL is reachable from your n8n instance.

Links and References

Discussion