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_url string
discovery_redirect_url string
reset_password_template_id string
locale string
reset_password_expiration_minutes int
code_challenge string
locale string

Response fields

request_id string
status_code int
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"
}

Common Error Types