# pipe_connect_browser_mismatch

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

</div>

## What it means

A Pipes `connect_url` is bound to the first browser that opens it, with a short-lived cookie scoped to `/pipes`. Any later visit, or the provider's callback, from a browser without that cookie is refused, so a leaked link cannot attach another person's account to your user. The flow is left unused.

## Likely causes

- The `connect_url` was sent by email or chat and opened on another device.
- Something opened the link before the user did, such as a link preview or a mail scanner.
- The browser dropped the cookie, for example a private window closed mid-flow.

## How to fix it

### For developers

- Send `connect_url` only as a redirect inside the end user's own signed-in session, never by email or chat.
- Create a new connection flow (`POST /v1/pipes/connections`) for the user and redirect them again.

### For IT administrators

- Start the connection again from the app, and finish it in the same browser.

## Example

HTTP status 403 from `GET /pipes/connect` in another browser:

```json
{
  "error": {
    "type": "permission",
    "code": "pipe_connect_browser_mismatch",
    "message": "This Pipes connect flow was opened in another browser, or the browser did not send its binding cookie; send the end user through a new connect flow from their own session",
    "doc_url": "https://docs.ohauthcat.com/errors/pipe_connect_browser_mismatch",
    "request_id": "req_01J9Z3K5V7W8X9Y0Z1A2B3C4D5"
  }
}
```

## Developer message

This Pipes connect flow was opened in another browser, or the browser did not send its binding cookie; send the end user through a new connect flow from their own session

## IT administrator message

This link was opened in a different browser. Start the connection again from the app

## 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>Dieser Link wurde in einem anderen Browser geöffnet. Starten Sie die Verbindung in der App erneut</span>
- `es`: <span lang="es" data-pagefind-ignore>Este enlace se abrió en otro navegador. Vuelva a iniciar la conexión desde la aplicación</span>
- `fr`: <span lang="fr" data-pagefind-ignore>Ce lien a été ouvert dans un autre navigateur. Relancez la connexion depuis l'application</span>
- `ja`: <span lang="ja" data-pagefind-ignore>このリンクは別のブラウザーで開かれました。アプリから接続をやり直してください</span>
- `pt-BR`: <span lang="pt-BR" data-pagefind-ignore>Este link foi aberto em outro navegador. Inicie a conexão novamente pelo aplicativo</span>

Security invariants: 58.
