Vtiger CRM icon

Vtiger CRM

Vtiger CRM (Open Source) Node
Join our community

Actions11

Overview

This node integrates with Vtiger CRM, an open-source customer relationship management system. The Login operation authenticates a user by obtaining a session token from the Vtiger API. It first requests a challenge token, then uses it combined with the user's access key to generate an MD5 hash for secure login.

This node is useful in workflows that require authenticated access to Vtiger CRM data or services. For example, you might use it to start a workflow that queries or updates CRM records after successfully logging in.

Properties

Name Meaning
Session Name A string representing the session identifier obtained through the Login operation. Used to authenticate subsequent requests.

Output

The output JSON contains the response from the Vtiger CRM API related to the login process. Typically, this includes:

  • success: Boolean indicating if login was successful.
  • result: An object containing session details such as the session name/token.
  • error: If login fails, an error object with message and code.

This output allows downstream nodes to use the session token for further authenticated operations.

Dependencies

  • Requires an API host URL, username, and access key credential configured in n8n to connect to the Vtiger CRM instance.
  • Uses the crypto-js library internally to compute MD5 hashes for secure authentication.
  • Network access to the Vtiger CRM webservice endpoint (/webservice.php) is necessary.

Troubleshooting

  • Common issues:
    • Invalid credentials (username or access key) will cause login failure.
    • Network connectivity problems to the Vtiger server.
    • Incorrect API host URL configuration.
  • Error messages:
    • If the initial challenge request fails, the node throws an error with the message and code returned by the API.
    • Typical error: "Invalid username or access key" or "Could not connect to host".
  • Resolution:
    • Verify credentials and API host URL.
    • Ensure the Vtiger CRM server is reachable.
    • Check that the access key matches the one configured in Vtiger for the user.

Links and References

Discussion