Toolzz Login icon

Toolzz Login

Make login Toolzz API

Overview

The Toolzz Login node allows users to authenticate with the Toolzz API by providing their email, password, institution code, and selecting the desired environment (production, homologation, or release). This node is useful in workflows where subsequent steps require an authenticated session or token from the Toolzz platform. For example, you might use this node at the start of a workflow to obtain authentication credentials before making further API requests to Toolzz services.

Practical Example

  • Automate login to Toolzz for scheduled data extraction.
  • Authenticate before performing actions like user management or course enrollment via Toolzz APIs.

Properties

Name Type Meaning
Email String The email address used for logging into the Toolzz API.
Password String The password associated with the provided email for Toolzz API authentication.
Código Instituicao String The institution code required for identifying the organization within Toolzz.
Ambiente Options Selects the environment to connect to: Production, Homologation, or Release.

Output

The node outputs a JSON object containing the response from the Toolzz API's /api/auth/login endpoint. The structure typically includes authentication details such as tokens or user information, depending on the API's response. The output is returned as a JSON array.

Example output structure:

[
  {
    "token": "string",
    "user": {
      "id": "number",
      "email": "string",
      // ...other user fields
    },
    // ...other response fields
  }
]

Note: The exact fields depend on the Toolzz API's response.

Dependencies

  • External Service: Toolzz API (https://kong.api.toolzz.com.br or other selected environments)
  • No n8n Credentials Required: All necessary parameters are provided as node properties.
  • Network Access: Ensure that your n8n instance can reach the selected Toolzz API environment.

Troubleshooting

  • Invalid Credentials: If the email, password, or institution code are incorrect, the API will likely return an authentication error. Double-check your input values.
  • Environment Selection: Choosing the wrong environment (e.g., using production credentials on homologation) may result in failed logins.
  • Common Error Messages:
    • 401 Unauthorized: Check your email, password, and institution code.
    • 404 Not Found: Verify the selected environment URL.
    • Connection Refused/Timeout: Ensure network connectivity to the Toolzz API endpoint.

Links and References

Discussion