Log In Or Create User By Email

POST

https://test.stytch.com/v1/magic_links/email/login_or_create

Send either a login or signup Magic Link to the User based on if the email is associated with a User already. A new or pending User will receive a signup Magic Link. An active User will receive a login Magic Link. For more information on how to control the status your Users are created in see the create_user_as_pending flag.

Next steps

The User is emailed a Magic Link which redirects them to the provided redirect URL. Collect the token from the URL query parameters and call Authenticate Magic Link to complete authentication.

Body parameters

email* string

login_magic_link_url string

signup_magic_link_url string

login_expiration_minutes int

signup_expiration_minutes int

login_template_id string

signup_template_id string

create_user_as_pending boolean

locale string

attributes object

code_challenge string

Response fields

status_code int

request_id string

user_id string

email_id string

user_created boolean

const stytch = require('stytch');

const client = new stytch.Client({
  project_id: 'PROJECT_ID',
  secret: 'SECRET',
});

const params = {
  email: "sandbox@stytch.com",
};

client.magicLinks.email.loginOrCreate(params)
  .then(resp => { console.log(resp) })
  .catch(err => { console.log(err) });

RESPONSE

{
  "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
}

Delete

Via email

Embeddable

Start

Reset options

Via SMS

Via Whatsapp

Via email

Register

Authenticate

Token

M2M Client

Rotate secret

Tokens

Configuration

Methods

Log in or create User by email

Next steps

Body parameters

Response fields

Common Error Types