Gitea icon

Gitea

Interact with Gitea via API
Join our community

Actions393

Overview

This node allows creating a new administrative user in the system. It is useful for scenarios where an administrator needs to programmatically add users with specific roles and permissions, such as onboarding new team members or migrating users from another platform. For example, you can automate the creation of admin accounts during deployment or synchronize users from an external directory.

Properties

Name Meaning
Created At Explicitly set the user's creation timestamp (useful for migrations). If omitted, defaults to the current time.
Email The email address of the new user.
Full Name The full name of the user.
Login Name The login name used by the user to sign in.
Must Change Password Boolean flag indicating if the user must change their password on first login. Defaults to true.
Password The password for the new user.
Restricted Boolean flag indicating if the user has restricted access. Defaults to true.
Send Notify Boolean flag to send a notification about the account creation to the user. Defaults to true.
Source Id Numeric identifier representing the source of the user (e.g., imported from an external system). Defaults to 0.
Username The username for the new user.
Visibility The visibility level of the user (e.g., public, private).

Output

The node outputs JSON data representing the newly created user object returned by the API. This typically includes user details such as ID, username, email, creation date, and other metadata. There is no indication that binary data is output by this node.

Dependencies

  • Requires an API key credential for authenticating with the target system's API.
  • The base URL for the API must be configured in the credentials.
  • The node uses standard HTTP headers for JSON communication (Accept: application/json, Content-Type: application/json).

Troubleshooting

  • Missing required fields: Ensure that mandatory properties like "Email" and "Username" are provided; otherwise, the API will reject the request.
  • Authentication errors: Verify that the API key credential is valid and has sufficient permissions to create admin users.
  • Invalid property values: Check that boolean flags are correctly set and that timestamps (if provided) follow the expected format.
  • API connectivity issues: Confirm that the base URL is correct and reachable from the n8n environment.

Links and References

  • Refer to the target system's API documentation for detailed information on user creation endpoints and property constraints.
  • Consult n8n documentation on how to configure API credentials and use HTTP-based nodes.

Discussion