Email and Password
Sign In
- Documentation
- Community
- Blog
- Overview
Authentication
Email and Password
Passwordless
OAuth
WebAuthn
Anonymous
MFA
User
- POSTSign Out
Storage
AI
JavaScript
React
Next.js
Vue
API Documentation
Backend Services
GraphQL
Client Libraries
Email and Password
Sign In
POST
/
signin
/
email-password
object
*
email
string
*
email
Required
string
A valid email
Add Example Value
password
string
*
password
Required
string
Add Example Value
curl --request POST \
--url https://local.auth.nhost.run/v1/signin/email-password \
--header 'Content-Type: application/json' \
--data '{
"email": "john.smith@nhost.io",
"password": "Str0ngPassw#ord-94|%"
}'
{
"mfa": {
"ticket": "<string>"
},
"session": {
"accessToken": "<string>",
"accessTokenExpiresIn": 123,
"refreshToken": "2c35b6f3-c4b9-48e3-978a-d4d0f1d42e24",
"user": {
"activeMfaType": "totp",
"avatarUrl": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"defaultRole": "user",
"displayName": "John Smith",
"email": "john.smith@nhost.io",
"emailVerified": true,
"id": "2c35b6f3-c4b9-48e3-978a-d4d0f1d42e24",
"isAnonymous": true,
"locale": "en",
"metadata": {
"firstName": "John",
"lastName": "Smith"
},
"phoneNumber": "<string>",
"phoneNumberVerified": true,
"roles": [
"me",
"user"
]
}
}
}
Body
application/json
email
string
requiredA valid email
password
string
requiredResponse
200 - application/json
mfa
object
mfa.ticket
string
session
object
session.accessToken
string
requiredsession.accessTokenExpiresIn
number
requiredsession.refreshToken
string
requiredRefresh token during authentication or when refreshing the JWT
session.user
object
session.user.activeMfaType
required
Multi-factor authentication type. A null value deactivates MFA
Available options:
totp
session.user.avatarUrl
string
requiredsession.user.createdAt
string
requiredsession.user.defaultRole
enum<string>
default: userrequiredAvailable options:
me
, user
session.user.displayName
string
requiredsession.user.email
string
requiredA valid email
session.user.emailVerified
boolean
default: falserequiredsession.user.id
string
Id of the user
session.user.isAnonymous
boolean
default: falserequiredsession.user.locale
string
default: enrequiredA two-characters locale
session.user.metadata
object
requiredsession.user.phoneNumber
string
requiredsession.user.phoneNumberVerified
boolean
default: falserequiredsession.user.roles
enum<string>[]
requiredAvailable options:
me
curl --request POST \
--url https://local.auth.nhost.run/v1/signin/email-password \
--header 'Content-Type: application/json' \
--data '{
"email": "john.smith@nhost.io",
"password": "Str0ngPassw#ord-94|%"
}'
{
"mfa": {
"ticket": "<string>"
},
"session": {
"accessToken": "<string>",
"accessTokenExpiresIn": 123,
"refreshToken": "2c35b6f3-c4b9-48e3-978a-d4d0f1d42e24",
"user": {
"activeMfaType": "totp",
"avatarUrl": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"defaultRole": "user",
"displayName": "John Smith",
"email": "john.smith@nhost.io",
"emailVerified": true,
"id": "2c35b6f3-c4b9-48e3-978a-d4d0f1d42e24",
"isAnonymous": true,
"locale": "en",
"metadata": {
"firstName": "John",
"lastName": "Smith"
},
"phoneNumber": "<string>",
"phoneNumberVerified": true,
"roles": [
"me",
"user"
]
}
}
}