Skip to content
Developers
Get started
Early access: these pages are being written and reviewed. Facts in the header boxes come straight from the product.

Redeem the Google sign-in MFA hand-off code

POST
/api/v1/auth/google/mfa
curl --request POST \
--url https://api.pitch2sale.com/api/v1/auth/google/mfa \
--header 'Content-Type: application/json' \
--data '{}'

Empty JSON body {}. Redeems the single-use hand-off code from the google_login_mfa cookie (cleared; about two minutes) after the /login?google_mfa=1 redirect. Returns the same challenge password login returns (mfa_required + mfa_token, or mfa_setup_required + mfa_token); continue with /auth/mfa/verify or /auth/mfa/setup/*.

Media typeapplication/json
object
Examplegenerated
{}

MFA challenge

Validation failed

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Expired or used (GOOGLE_MFA_EXPIRED)

Rate limit exceeded

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}