freesewing/markdown/dev/reference/backend/oauth/en.md

---
title: Oauth
---

## Oauth initialisation
```
POST /oauth/init
{
  'provider': 'github',
  'language': 'fr'
}
```
On success:
```
200
{
  'state': '5d5132041ad3f369443f1d7b'
}
```
On failure:
```
400
```
 - This triggers an Oauth flow
 - `provider` should be one of `google` or `github`
 - `language` should be one of the [configured language codes](https://github.com/freesewing/backend/blob/develop/src/config/index.js#L32)
 - The frontend will use the state value to initialize an Oauth session. We'll check the state value when we receive the Oauth callback at the backend

## Oauth callback
```
GET /oauth/callback/from/:provider
```
On success: Redirects to the frontend

This is part of the Oauth flow. It fetches the user info from the Oauth provider. If it can't match it with a user, it will create a user account.  
In other words, this will handle both log in and sign up.

The frontend redirect will contain a confirmation ID in the URL that we'll `POST` back in the next Oauth flow step.

## Oauth login
```
POST /oauth/login
{
  'confirmation': '98e132041ad3f369443f1d3d'
}
```
On success: The account data
On failure:
```
400
```

This is the last step of the Oauth process. It logs a user in.