ImmyBot

Overview

The node named "ImmyBot" integrates with the ImmyBot API to manage users and other resources. Specifically, for the "User" resource and the "Create User" operation, it allows creating a new user in the system based on an existing person record. This is useful in scenarios where you have person data already stored and want to quickly provision user accounts linked to those persons, optionally granting them management access.

Practical examples include:

• Automating user account creation after onboarding a new employee whose personal details are already recorded.
• Syncing user accounts from a CRM or HR system by referencing person IDs.
• Controlling user permissions at creation time by toggling management access.

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 to create the user. 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. The output can be used downstream in workflows to reference the created user or trigger further actions.

No binary data output is indicated.

Dependencies

• Requires an OAuth2 API credential configured for ImmyBot with appropriate permissions.
• Needs the subdomain of the ImmyBot instance to construct the base URL for API requests.
• The node sends requests to https://{subdomain}.immy.bot/api/v1.

Troubleshooting

• Common issues:

  • Missing or invalid API credentials will cause authentication failures.
  • Providing an incorrect or non-existent Person ID will likely result in an error from the API.
  • Network connectivity problems to the ImmyBot service can cause request timeouts or failures.

• Error messages:

  • Authentication errors usually indicate misconfigured or expired credentials; re-authenticate or update credentials.
  • Validation errors related to Person ID suggest verifying that the ID exists and is correct.
  • API rate limits or permission errors require checking the API key's scope and usage limits.

Links and References

• ImmyBot API Documentation (Assumed official docs for more details)
• OAuth2 authentication setup guides within n8n documentation for configuring API credentials