Skip to content
Dashboard
Theme
Theme

directory_source_oauth_confirm_required

Developer and IT administrator messages for directory_source_oauth_confirm_required.

View Markdown

Since API version 1.1.

Field Value
Type permission
Status 403
Surfaces api, portal
Retryable No

The authorization_url of a Connect Gusto, BambooHR or Google start is an OhAuthCat confirm page that names the organization and environment the directory will attach to. Only pressing Continue on that page, in the same browser, sends the IT admin on to the provider. This code means the flow reached OhAuthCat without that confirmation, so nothing was connected.

  • The link was opened in one browser and the provider’s consent screen finished in another.
  • The browser blocked or dropped the confirm page’s cookie, for example in a strict privacy mode.
  • Something posted the confirm form without the page’s own csrf field or from another origin.
  • The provider’s consent URL was used directly instead of the authorization_url.
  • Send the IT admin’s browser to the authorization_url itself, not to a provider URL you build.
  • Start a new connect (POST /v1/directories/{dir}/source/oauth/start) and ask them to finish it in one browser.
  • Open the setup link again, check the organization name on the page and press Continue, then finish in the same browser.

The provider returns the browser to OhAuthCat, which redirects to the app’s return_url with the error:

https://app.example.com/setup?ohauthcat_oauth=error&error_code=directory_source_oauth_confirm_required&directory_id=dir_01J9Z3K5V7W8X9Y0Z1A2B3C4D5

The connect link was not confirmed on its OhAuthCat confirm page (missing or mismatched confirm cookie, CSRF field or Origin), so nothing was connected; open the authorization_url and press Continue

This connection wasn’t confirmed. Open the link again and press Continue

The hosted portal shows these machine translations, which native speakers have not reviewed yet. Placeholders and identity provider console labels stay in English.

  • de: Diese Verbindung wurde nicht bestätigt. Öffnen Sie den Link erneut und klicken Sie auf Weiter
  • es: Esta conexión no se confirmó. Vuelva a abrir el enlace y pulse Continuar
  • fr: Cette connexion n’a pas été confirmée. Rouvrez le lien et cliquez sur Continuer
  • ja: この接続は確認されていません。リンクをもう一度開き、[続行] を押してください
  • pt-BR: Esta conexão não foi confirmada. Abra o link novamente e clique em Continuar

Security invariants: 88.