Toolzz Catalog icon

Toolzz Catalog

Get School and Classes of Toolzz API

Overview

This n8n node, Toolzz Catalog, retrieves school and class catalog information from the Toolzz API. It is designed to fetch data from different environments (Production, Homologation, Release) based on user selection. The node is useful in scenarios where you need to integrate or synchronize educational catalog data from Toolzz into other systems, automate reporting, or trigger workflows based on catalog updates.

Practical examples:

  • Automatically importing the latest school/class lists into a CRM or LMS.
  • Triggering notifications when new classes are added to the catalog.
  • Periodically backing up catalog data for compliance or analytics.

Properties

Name Type Meaning
AccessToken String The bearer token used for authenticating requests to the Toolzz API.
Ambiente Options Selects the environment to connect to: Prod, Homol, or Release.
Pagina String Specifies the page or catalog identifier to retrieve; sent as the catalog query param.

Output

The node outputs a JSON array containing the response from the Toolzz API's /v2/api/catalogv3 endpoint. The structure of each item in the array depends on the API's response, but typically includes details about schools and classes.

Example output:

[
  {
    "schoolId": "123",
    "schoolName": "Example School",
    "classes": [
      {
        "classId": "456",
        "className": "Math 101"
      }
    ]
  }
]

Note: The actual fields depend on the Toolzz API.

Dependencies

  • External Service: Requires access to the Toolzz API at one of the specified environments.
  • API Key: A valid AccessToken (Bearer token) is required for authentication.
  • n8n Configuration: No special credentials configuration; the token is provided directly as a property.

Troubleshooting

Common issues:

  • Invalid or expired AccessToken:
    • Error: 401 Unauthorized or similar authentication errors.
    • Solution: Ensure the AccessToken is correct and has not expired.
  • Incorrect Ambiente selection:
    • Error: Connection failures or unexpected data.
    • Solution: Verify that the selected environment is accessible and contains the expected data.
  • Empty or invalid Pagina value:
    • Error: API returns empty results or errors related to missing/invalid parameters.
    • Solution: Check that the Pagina field is set correctly according to the API documentation.

Links and References

Discussion