Toolzz Create Studant on Institution icon

Toolzz Create Studant on Institution

Get School and Classes of Toolzz API

Overview

This n8n node, Toolzz Create Student on Institution, is designed to create a new student user within an institution using the Toolzz API. It collects student details and sends them to the selected Toolzz environment (Production, Homologation, or Release) via an HTTP request. This node is useful for automating the onboarding of students into the Toolzz platform, especially in educational workflows where bulk or automated student registration is required.

Practical examples:

  • Automate student enrollment when a new record is added to your CRM.
  • Batch import students from a spreadsheet into Toolzz.
  • Integrate with other systems to synchronize student data automatically.

Properties

Name Type Meaning
AccessToken String The authentication token required to authorize requests to the Toolzz API.
Ambiente Options Selects the target Toolzz environment (Prod, Homol, Release) for the API request.
E-Mail String The email address of the student being created.
Nome String The full name of the student.
ID Da Escola String The unique identifier of the school/institution where the student will be registered.

Note: The code also references additional parameters (birth_date, institutionCode, password_confirmation, password) that are not present in the provided properties list. If these are required, ensure they are included in the node configuration.

Output

The node outputs the JSON response received from the Toolzz API after attempting to create the student. The structure of this output depends on the API's response but typically includes information about the newly created student or error details if the creation failed.

Example output (structure may vary):

[
  {
    "id": "12345",
    "name": "Student Name",
    "email": "student@example.com",
    "institutionId": "67890",
    // ...other fields returned by the API
  }
]
  • No binary data is produced; output is always in JSON format.

Dependencies

  • External Service: Toolzz API (requires network access to the selected environment).
  • API Key: A valid AccessToken is required for authorization.
  • n8n Configuration: No special credentials setup in n8n; the AccessToken is provided as a property.

Troubleshooting

Common Issues:

  • Invalid AccessToken: If the token is missing or incorrect, the API will reject the request. Ensure you provide a valid AccessToken.
  • Missing Required Fields: If any required student information is omitted, the API may return validation errors.
  • Incorrect Environment Selection: Choosing the wrong environment (Ambiente) could result in requests going to a test server or failing due to unavailable endpoints.

Common Error Messages:

  • "401 Unauthorized": Check that the AccessToken is correct and has not expired.
  • "400 Bad Request": Review all input fields for completeness and correctness.
  • "404 Not Found": Verify the endpoint URL and the selected environment.

Links and References

Discussion