Actions111
- Item Actions
- Webhook Actions
- Collection Actions
- File Actions
- Activity Actions
- Asset Actions
- Authentication Actions
- Extension Actions
- Field Actions
- Folder Actions
- Permission Actions
- Preset Actions
- Relation Actions
- Revision Actions
- Role Actions
- Setting Actions
- User Actions
- Utility Actions
Overview
This n8n node is designed to invite a new user to a system (likely Directus, based on the references). It allows you to specify the user's email and role, and optionally customize the invitation URL. This node is useful in automated workflows where you need to onboard users programmatically, such as when integrating sign-up forms or automating team management.
Practical examples:
- Automatically inviting new employees to your platform after they are added to an HR system.
- Sending invitations to users who register via a web form.
- Assigning specific roles to invited users based on workflow logic.
Properties
| Name | Meaning |
|---|---|
| User email to invite. This is the email address where the invitation will be sent. | |
| Role | Role of the new user. You must provide the identifier for the role that should be assigned to the invited user. |
| Additional Fields | Collection of optional fields: - Invite URL: Provide a custom invite URL which the link in the email will lead to. The invite token will be passed as a parameter. Note: Requires configuration of USER_INVITE_URL_ALLOW_LIST environment variable. |
Output
The node outputs a JSON object containing the result of the invite operation. The structure typically includes information about the invitation status and may include details about the invited user or the invitation link. The exact output fields depend on the underlying API response.
Dependencies
- External Service: Requires access to a Directus instance (or similar service) with API credentials.
- Environment Variable: To use a custom Invite URL, the
USER_INVITE_URL_ALLOW_LISTenvironment variable must be configured in your Directus instance.
Troubleshooting
Common Issues:
- Missing or invalid email addresses will cause the invite to fail.
- Providing an incorrect or unauthorized role ID will result in errors.
- If using a custom Invite URL without configuring
USER_INVITE_URL_ALLOW_LIST, the request will be rejected.
Error Messages and Resolutions:
"Invalid email": Ensure the email address is correctly formatted and not already in use."Role not found": Double-check the role ID provided."Invite URL not allowed": Make sure the custom URL is included in theUSER_INVITE_URL_ALLOW_LISTenvironment variable.