---
title: "POST /v0/auth/github"
method: POST
path: "/v0/auth/github"
tags: ["auth"]
---

# POST /v0/auth/github

`POST /v0/auth/github`

## Request body

- JsonOAuth
  - `code` string, required
  - `state` string, required

## Response `202`

successfully enqueued operation

- JsonOAuthUser
  - `plan` 'free' | 'pro' | 'team' | 'enterprise'
  - `user` JsonAuthUser, required
    - `creation` string, date-time, required
    - `expiration` string, date-time, required
    - `token` string, required
    - `user` JsonUser, required
      - `admin` boolean, required
      - `created` string, date-time
      - `email` string, required
      - `locked` boolean, required
      - `name` string, required
      - `slug` string, required
      - `uuid` string, uuid, required

## Other responses

- `4XX` — Error
- `5XX` — Error

## Changes

- **2026-06-19** `8179e0db464a` — 1 warning
  - added the new `pro` enum value to the `plan/allOf[#/components/schemas/PlanLevel]/` response property for the response status `202`
- **2026-06-14** `814ceb2390ab` — 1 info
  - added the optional property `user/user/created` to the response with the `202` status
- **2026-03-20** `36c8ad753527` — 1 warning, 1 info
  - removed the optional property `user/user/created` from the response with the `202` status
  - removed the `pro` enum value from the `plan/allOf[#/components/schemas/PlanLevel]/` response property for the response status `202`

[Change history](https://skmtc.dev/bencherdev/apis/bencher-api/changes/v0/auth/github/post.md)

---

[API](https://skmtc.dev/bencherdev/apis/bencher-api.md) · [All operations](https://skmtc.dev/bencherdev/apis/bencher-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bencherdev/bencher-api/revisions/74e9728a444e/schema)
