B2B Saas Authentication

/

API reference

/

Email one-time passcodes (OTP)

/

Organization

/

Send login or signup OTP

Send login or signup email

POSThttps://test.stytch.com/v1/b2b/otps/email/login_or_signup

Send either a login or signup email OTP to a Member. A new, pending, or invited Member will receive a signup email OTP. Non-active members will have a pending status until they successfully authenticate. An active Member will receive a login email OTP.

The OTP is valid for 10 minutes. Only the most recently sent OTP is valid: when an OTP is sent, all OTPs previously sent to the same email address are invalidated, even if unused or unexpired.


Body parameters


organization_id*string

email_address*string

login_template_idstring

signup_template_idstring

localestring

Response fields


request_idstring

status_codeint

member_idstring

member_createdboolean

memberobject

organizationobject
curl --request POST \
  --url https://test.stytch.com/v1/b2b/otps/email/login_or_signup \
  -u 'PROJECT_ID:SECRET' \
  -H 'Content-Type: application/json' \
  -d '{
    "organization_id": "organization-test-07971b06-ac8b-4cdb-9c15-63b17e653931",
    "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_created": true,
  "member": {...},
  "organization": {...}
}