ImmyBot icon

ImmyBot

ImmyBot Node

Overview

The node named "ImmyBot" integrates with the ImmyBot API, allowing users to perform various operations related to different resources. Specifically, for the User resource and the Create User operation, this node enables creating a new user in the ImmyBot system based on an existing person record. This is useful in scenarios where you manage people separately and want to convert or register them as users within ImmyBot, optionally granting them management access.

Practical examples include:

  • Automating user creation workflows when onboarding new employees or team members.
  • Synchronizing user data from a CRM or HR system by referencing person IDs.
  • Controlling access levels by setting management permissions during user creation.

Properties

Name Meaning
Has Management Access Boolean flag indicating whether the created user should have management access (true/false).
Person ID Numeric identifier of the person from whom the user will be created. This is required.

Output

The node outputs JSON data representing the result of the user creation request. This typically includes details about the newly created user such as their unique ID, status, and any metadata returned by the ImmyBot API.

If the node supports binary data output, it would generally relate to file attachments or media associated with the user, but no such indication is present here.

Dependencies

  • Requires an OAuth2 API credential configured with ImmyBot, including a subdomain used to construct the base URL for API requests.
  • The node depends on the ImmyBot REST API endpoint at https://{subdomain}.immy.bot/api/v1.
  • Proper API authentication credentials must be set up in n8n for successful communication.

Troubleshooting

  • Common issues:
    • Invalid or missing Person ID: Ensure the Person ID provided exists and is valid in the ImmyBot system.
    • Authentication errors: Verify that the OAuth2 credentials are correctly configured and have not expired.
    • Permission denied: If the user lacks rights to create users or assign management access, the API may reject the request.
  • Error messages:
    • "Unauthorized" or "Invalid token": Check API credentials and refresh tokens if necessary.
    • "Person not found": Confirm the Person ID corresponds to an existing person.
    • "Bad Request": Validate all required fields and their formats.

Links and References

Discussion