---
title: "Oauth Setup Callback"
method: GET
path: "/v2/auth/setup/{provider_id}"
tags: ["Auth Service (v2)"]
---

# Oauth Setup Callback

`GET /v2/auth/setup/{provider_id}`

Handle OAuth setup callback redirect from GitHub Apps.

This endpoint handles the "Setup URL" callback from GitHub Apps, which is
triggered when a user installs or updates their GitHub App installation.

For "update" actions (user modified repo access via GitHub), we just show
a success page since no token exchange is needed.

For new installations with code/state, we process similar to the regular
OAuth callback.

## Path parameters

- `provider_id` string, required

## Query parameters

- `code` string — Authorization code from OAuth provider
- `state` string — State parameter containing auth_id
- `setup_action` string — Setup action from GitHub App
- `installation_id` integer — GitHub App installation ID
- `error` string — Error code from OAuth provider
- `error_description` string — Error description from OAuth provider

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/langchain-ai/apis/langsmith-deployment-control-plane-api.md) · [All operations](https://skmtc.net/langchain-ai/apis/langsmith-deployment-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langchain-ai/langsmith-deployment-control-plane-api/versions/a0cd098699b4/schema)