B2B Saas Authentication

/

API reference

/

Passwords

/

Reset Options

/

Discovery Password reset by email start

Email reset start

POSThttps://test.stytch.com/v1/b2b/passwords/discovery/email/reset/start

Initiates a password reset for the email address provided, when cross-org passwords are enabled. This will trigger an email to be sent to the address, containing a magic link that will allow them to set a new password and authenticate.

This endpoint adapts to your Project's password strength configuration. If you're using zxcvbn, the default, your passwords are considered valid if the strength score is >= 3. If you're using LUDS, your passwords are considered valid if they meet the requirements that you've set with Stytch. You may update your password strength configuration in the stytch dashboard.


Body parameters


email_address*string

reset_password_redirect_urlstring

discovery_redirect_urlstring

reset_password_template_idstring

localestring

reset_password_expiration_minutesint

code_challengestring

localestring

Response fields


request_idstring

status_codeint
curl --request POST \
  --url https://test.stytch.com/v1/b2b/passwords/discovery/email/reset/start \
  -u 'PROJECT_ID:SECRET' \
  -H 'Content-Type: application/json' \
  -d '{
    "email_address": "sandbox@stytch.com"
  }'

RESPONSE

200
{
  "status_code": 200,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "member_id": "member-test-32fc5024-9c09-4da3-bd2e-c9ce4da9375f",
  "member_email_id": "member-email-test-1dd089b3-8904-47ef-b943-987968e549d4",
  "member": {...}
}

Common Error Types