---
title: "POST /users/oauth/handleCallback/{providerId}"
method: POST
path: "/users/oauth/handleCallback/{providerId}"
tags: ["users"]
---

# POST /users/oauth/handleCallback/{providerId}

`POST /users/oauth/handleCallback/{providerId}`

## Path parameters

- `providerId` string, required

## Request body

- OauthUserAuthorizeDto
  - `code` string, required
  - `state` string, required
  - `redirectUri` string, required

## Response `201`

- LoginResponseDto
  - `accessToken` string, required
  - `user` SanitizedUserResponseDto, required
    - `id` string, required
    - `email` string, required
    - `fullName` string, required
    - `profilePictureUrl` string, nullable, required
    - `verifiedAt` string, date-time, nullable, required

## Other responses

- `500` — Something went wrong.

## Changes

> 50 revisions in range; 1 could not be searched.

- **2023-10-09** `b085973a5e75` — 1 info
  - added the required property `user/profilePictureUrl` to the response with the `201` status
- **2023-10-09** `8055fd23b9fe` — 1 warning
  - removed the request property `projectId`
- **2023-10-08** `cd20da6c2de2` — 1 breaking
  - added the new required request property `projectId`
- **2023-10-06** `e5e54579a918` — 1 info
  - endpoint added
- **2023-09-20** `6610666a572e` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/agentlabs-dev/apis/agentlabs-api/changes/users/oauth/handleCallback/:providerId/post.md)

---

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