Toolzz Attach Students icon

Toolzz Attach Students

Attach Students Toolzz API

Overview

The Toolzz Attach Students node integrates with the Toolzz API to attach (enroll) multiple students to a specific class. It is designed for educational platforms or automation workflows where you need to programmatically assign students to classes in bulk.

Common scenarios:

  • Automating student enrollment after registration.
  • Syncing student lists from external systems into Toolzz.
  • Batch updating class rosters based on administrative actions.

Practical example:
You have a list of new students and want to enroll them all into a particular class in Toolzz without manual intervention.

Properties

Name Type Meaning
AccessToken String The authentication token required to authorize requests to the Toolzz API.
Ambiente Options Selects the environment (Prod, Homol, Release) to which the API request will be sent.
ID Da Turma String The unique identifier of the class to which students will be attached.
IDs Dos Alunos String A comma-separated string of student IDs to be attached to the specified class.

Output

The node outputs the JSON response returned by the Toolzz API after attempting to attach the students. The structure of this output depends on the API's response, but typically includes information about the operation's success or failure and possibly details about the students or class.

Example output:

[
  {
    // ...fields as returned by the Toolzz API, e.g.,
    "success": true,
    "attachedUsers": ["123", "456"],
    "classId": "789"
  }
]

Note: The actual fields depend on the Toolzz API's implementation.

Dependencies

  • External Service: Requires access to the Toolzz API endpoint.
  • API Key: You must provide a valid AccessToken for authorization.
  • n8n Configuration: No special credentials configuration; the token is provided directly as a property.

Troubleshooting

Common issues:

  • Invalid AccessToken: If the token is missing or incorrect, the API will likely return an authentication error.
  • Incorrect Class ID: Providing a non-existent or invalid class ID may result in a "not found" or similar error.
  • Malformed Student IDs: Ensure that the "IDs Dos Alunos" field contains a comma-separated list of valid user IDs (e.g., 123,456,789).

Error messages and resolutions:

  • "401 Unauthorized": Check that your AccessToken is correct and has not expired.
  • "404 Not Found": Verify the Class ID and ensure the selected environment is correct.
  • "400 Bad Request": Make sure the users' IDs are properly formatted and all required fields are filled.

Links and References

Discussion