---
title: "POST /v1/auth/oauth2/login"
method: POST
path: "/v1/auth/oauth2/login"
tags: ["AuthService"]
---

# POST /v1/auth/oauth2/login

`POST /v1/auth/oauth2/login`

## Request

- The document declares no server URL.
- Auth: none declared

## Request body

- MagicboxOauthOAuth2LoginRequest
  - `app` integer
  - `config` MagicboxConfigOAuth2Config
    - `app` integer
    - `clientId` string
    - `clientSecret` string
    - `callbackUri` string
    - `authUrl` string
    - `tokenUrl` string
    - `scopes` string[]
    - `loginUrl` string
  - `user` MagicboxOauthOAuth2User
    - `openID` string
    - `name` string
    - `nickname` string
    - `email` string
    - `avatar` string
    - `app` integer
    - `remark` string
    - `raw` string, bytes
  - `portal` string

## Response `200`

OK

- GoddessApiV1LoginReply
  - `token` string

## Changes

- **2026-03-19** `ccc3367d0211`: 1 info
  - endpoint added
- **2026-02-27** `9f425f6d2358`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/aide-family/apis/aide-family-goddess-api/changes/v1/auth/oauth2/login/post.md)

---

[API](https://skmtc.dev/aide-family/apis/aide-family-goddess-api.md) - [All operations](https://skmtc.dev/aide-family/apis/aide-family-goddess-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aide-family/apis/aide-family-goddess-api/revisions/d97780a0ed10?raw)