# Confirm step of a directory source connect link

<div class="api-op" data-api-operation>
<div class="api-op__main">

<p class="api-endpoint"><span class="method method-get">GET</span> <code>/v1/directory_sources/oauth/confirm</code></p>

The authorization_url of a Connect Gusto, BambooHR or Google start. It shows a page naming the organization and environment the directory grant will attach to, with a Continue button. It never redirects to the provider. It sets a short-lived HttpOnly, SameSite=Strict cookie that the form posts back with. An unknown, expired or used state answers `directory_source_oauth_state_invalid` (400): an HTML page for a browser, JSON otherwise.

<dl class="api-facts"><div><dt>Scope</dt><dd><code>public</code></dd></div><div><dt>Auth</dt><dd>None</dd></div><div><dt>Since</dt><dd>1.1</dd></div></dl>

## Query parameters

<ul class="api-fields">
<li class="api-field">
<p class="api-field__head"><code class="api-field__name">state</code> <span class="api-field__type">string</span></p>

<p class="api-field__chips">max length 256</p>
</li>
</ul>

## Headers

<ul class="api-fields">
<li class="api-field">
<p class="api-field__head"><code class="api-field__name">OhAuthCat-Version</code> <span class="api-field__type">string</span></p>
Minor version; defaults to the environment's pin.
</li>
</ul>

## Responses

<ul class="api-responses">
<li class="api-response"><span class="api-status api-status--ok">200</span> <span>The confirm page.</span></li>
<li class="api-response"><span class="api-status api-status--bad">400</span> <span>`<a href="/errors/directory_source_oauth_state_invalid/">directory_source_oauth_state_invalid</a>`. <span class="api-field__type">Error</span></span></li>
<li class="api-response"><span class="api-status api-status--bad">429</span> <span>Code: <a href="/errors/rate_limited/">rate_limited</a>. Retry-After is set. <span class="api-field__type">Error</span></span></li>
<li class="api-response"><span class="api-status api-status--bad">503</span> <span>Code: <a href="/errors/service_unavailable/">service_unavailable</a>. Retry-After is set; writes are paused. <span class="api-field__type">Error</span></span></li>
<li class="api-response"><span class="api-status api-status--neutral">default</span> <span>Any other error, including <a href="/errors/internal_error/">internal_error</a>. Every code is in the error catalogue. <span class="api-field__type">Error</span></span></li>
</ul>

Errors share one shape; see the [error code catalogue](/errors/).

</div>
<div class="api-op__code">

**curl**

```sh wrap
curl -X GET \
  "https://api.ohauthcat.com/v1/directory_sources/oauth/confirm"
```

**Node**

```javascript wrap
const response = await fetch(
  "https://api.ohauthcat.com/v1/directory_sources/oauth/confirm",
  {
    method: "GET",
  },
);
const data = await response.json();
```

**Python**

```python wrap
import os
import requests

response = requests.get(
    "https://api.ohauthcat.com/v1/directory_sources/oauth/confirm",
)
data = response.json()
```

<p class="api-empty">Response 200: no body.</p>

</div>
</div>
