# directory_source_oauth_confirm_required

<!-- Generated by scripts/generate.ts. Do not edit. -->

<!-- Source: core commit `f70874a3916ad5b24a8619246cbae6cc8bc24d27`. -->

<div data-pagefind-ignore>

Since API version `1.1`.

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

</div>

## What it means

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.

## Likely causes

- 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`.

## How to fix it

### For developers

- 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.

### For IT administrators

- Open the setup link again, check the organization name on the page and press Continue, then finish in the same browser.

## Example

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

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

## Developer message

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

## IT administrator message

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

## Translated IT administrator messages

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

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

Security invariants: 88.
