Consumer Authentication

/

API reference

/

One-time passcodes (OTP)

/

Via email

/

Login or create user

Log in or create User by email

POSThttps://test.stytch.com/v1/otps/email/login_or_create

Send a one-time passcode (OTP) to a User using their email. If the email is not associated with a User already, a User will be created.

Next steps

Collect the OTP which was delivered to the User. Call Authenticate OTP using the OTP code along with the phone_id found in the response as the method_id.

Body parameters

email* string
expiration_minutes int
login_template_id string
signup_template_id string
locale string
create_user_as_pending boolean
attributes object

Response fields

status_code int
request_id string
user_id string
email_id string
user_created boolean
curl --request POST \
  --url https://test.stytch.com/v1/otps/email/login_or_create \
  -u 'PROJECT_ID:SECRET' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "sandbox@stytch.com"
  }'

RESPONSE

200
{
  "status_code": 200,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "user_id": "user-test-16d9ba61-97a1-4ba4-9720-b03761dc50c6",
  "email_id": "email-test-81bf03a8-86e1-4d95-bd44-bb3495224953",
  "user_created": true
}

Common Error Types