Directus (DrWade)

Consume Directus API

Actions109

Overview

The Authentication → Request Password Reset operation in this n8n node allows you to initiate a password reset process for a user in a Directus instance. By providing the user's email address, the node triggers Directus to send a password reset email to that user. Optionally, you can specify a custom reset URL that will be used in the email link.

Common scenarios:

Automating user support workflows where users request password resets.
Integrating with helpdesk or self-service portals to allow users to trigger password resets without manual admin intervention.

Practical example:
A user forgets their password and submits a request via your web portal. An n8n workflow uses this node to call Directus and send the user a password reset email.

Properties

Name	Type	Meaning
Email	String	Email address of the user you're requesting a reset for. (Required)
Additional Fields	Object	Optional collection of extra parameters.
└ Reset URL	String	Custom reset URL for the password reset link. The reset token will be passed as a parameter. Requires configuration of `PASSWORD_RESET_URL_ALLOW_LIST` in Directus.

Output

The output is a JSON object containing the response from the Directus API after attempting to request a password reset.

Typical structure:

{
  "json": {
    // Response data from Directus, often empty on success or may include status info
  }
}

If an error occurs and "Continue On Fail" is enabled, the output will contain:
```
{
  "json": {
    "error": "Error message"
  }
}
```

Dependencies

Directus API: You must have access to a running Directus instance.
API Credentials: The node requires valid Directus API credentials configured in n8n.
Environment Variable (optional): To use a custom reset URL, ensure the PASSWORD_RESET_URL_ALLOW_LIST environment variable is set in your Directus instance to allow your specified URLs.

Troubleshooting

Common issues:

Invalid Email: If the provided email does not exist in Directus, the API may return an error or silently succeed (depending on Directus settings).
Custom Reset URL Not Working: If you provide a custom reset URL but have not configured PASSWORD_RESET_URL_ALLOW_LIST, Directus will reject the request.
Missing Credentials: If API credentials are missing or incorrect, authentication errors will occur.

Error messages and resolutions:

"error": "Request failed with status code 401": Check your Directus API credentials in n8n.
"error": "Reset URL not allowed": Ensure your custom reset URL is included in the PASSWORD_RESET_URL_ALLOW_LIST environment variable in Directus.
"error": "User not found": Verify the email address exists in your Directus user database.