Skip to main content
POST
/
api
/
v1
/
auth
/
login
Login (email + password)
curl --request POST \
  --url https://api.flowxi.app/api/v1/auth/login \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "[email protected]",
  "password": "+-0pBNvYgxwmi/#iw",
  "device_type": "web",
  "device_name": "Chrome (Mac)",
  "device_id": "device-uuid-123",
  "country": "BJ"
}
'
{
  "code": "LOGIN_SUCCESS",
  "message": "Login successful.",
  "mfa_required": false,
  "access_token": "125|XXXXXXXXXXXXXXXXXXXXXXXX",
  "token_type": "Bearer",
  "account_status": "active",
  "user_id": 123
}

Body

application/json
​
email
string<email>
required
​
password
string
required
Example:

"+-0pBNvYgxwmi/#iw"

​
device_type
string
required
Example:

"web"

​
device_name
string
required
Example:

"Chrome (Mac)"

​
device_id
string
required
Example:

"device-uuid-123"

​
country
string | null
Example:

"BJ"

Response

Login success (token) OR 2FA challenge returned.

​
code
string
required
Example:

"OK"

​
message
string
required
Example:

"OK"

​
mfa_required
boolean
required
Example:

false

​
access_token
string
required
Example:

"125|XXXXXXXXXXXXXXXXXXXXXXXX"

​
token_type
string
required
Example:

"Bearer"

​
account_status
string
required
Example:

"active"

​
user_id
integer
required
Example:

123