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_id string
signup_template_id string
locale string

Response fields

request_id string
status_code int
member_id string
member_created boolean
member object
organization object
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": {...}
}

Common Error Types