# connection_not_activated

<!-- 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  | `broker`     |
| Retryable | No           |

</div>

## What it means

The connection's test sign-in passed, but nobody activated the connection, so OhAuthCat refuses real sign-ins through it. A tested connection stays inactive until someone switches it on, so a half-finished setup never signs users in by accident.

## Likely causes

- The IT administrator ran the test sign-in in the setup portal but closed it before the last step.
- Your app created and tested the connection through the API but never called the activate endpoint.
- Someone deactivated the connection and then sent users through it again.

## How to fix it

### For developers

- Activate the tested connection: `POST /v1/connections/{conn}/activate` with a secret key that has `connections:write`. It answers 200 with the connection once it is active.
- Or send the IT administrator back to the setup portal link to finish the last step, which activates the connection for them.
- Look up the request ID in the sign-in log to confirm which connection the sign-in used.

### For IT administrators

- Open the setup link the app gave you and finish the last step to switch single sign-on on, or ask the app's team to activate it.

## Example

The browser shows the hosted error page with HTTP status 403:

```text
Error code: connection_not_activated
Request ID: req_01J9Z3K5V7W8X9Y0Z1A2B3C4D5
```

## Developer message

The connection passed its test sign-in but was never activated: activate it with POST /v1/connections/{id}/activate or finish setup in the portal

## IT administrator message

Single sign-on for this app isn't switched on yet

## 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>Single Sign-On ist für diese App noch nicht eingeschaltet</span>
- `es`: <span lang="es" data-pagefind-ignore>El inicio de sesión único para esta aplicación aún no está activado</span>
- `fr`: <span lang="fr" data-pagefind-ignore>L'authentification unique n'est pas encore activée pour cette application</span>
- `ja`: <span lang="ja" data-pagefind-ignore>このアプリのシングルサインオンはまだ有効になっていません</span>
- `pt-BR`: <span lang="pt-BR" data-pagefind-ignore>O login único para este aplicativo ainda não está ativado</span>

Security invariants: 6.
