---
title: Authentication Fail URL
description: The URL or URI to which the agent redirects the user after a failed authentication.
component: java-agents
version: 2025.11
page_id: java-agents:properties-reference:org.forgerock.agents.authn.fail.url
canonical_url: https://docs.pingidentity.com/java-agents/2025.11/properties-reference/org.forgerock.agents.authn.fail.url.html
---

# Authentication Fail URL

The URL or URI to which the agent redirects the user after a failed authentication.

If this property is not set, the agent redirects the user to the URL defined in [Goto URL](org.forgerock.agents.default.goto.url.html). If neither property is set, the agent returns an HTTP 400 Bad Request.

To configure the agent to send the reason for authentication failure in a named query parameter, configure [Authentication Fail Reason Parameter Name](org.forgerock.agents.authn.fail.reason.parameter.name.html).

|                          |                                                                                                                                             |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Property name            | `org.forgerock.agents.authn.fail.url`                                                                                                       |
| Aliases                  | `org.forgerock.agents.authn.fail.url`   Introduced in Java Agent 5.7   [Recognized](preface.html#how_am_manages_multiple_aliases) from AM 7 |
| Function                 | Authentication failure                                                                                                                      |
| Type                     | String                                                                                                                                      |
| Bootstrap property       | No                                                                                                                                          |
| Required property        | No                                                                                                                                          |
| Restart required         | No                                                                                                                                          |
| Local configuration file | `AgentConfig.properties`                                                                                                                    |
| AM console               | Tab: `Miscellaneous (from AM 7)`Title: `Authentication Fail URL`Legacy title: `Authentication Fail Reason Url`                              |