/
Contact usSee pricingStart building
    Overview
    Changelog

    Pre-built UI

    StytchB2B
      Configuration
      Callbacks
    Admin Portal
      SSO
      Org Settings
      Member Management
      SCIM
    B2BIdentityProviderBeta
      Configuration
      UI Callbacks

    Headless

    Organizations
      Get Organization
      Get Organization by Slug
      Update Organization
      Delete Organization
    Members
      Get Member
      Create Member
      Update Member
      Search Members
      Delete Member
      Reactivate Member
      Delete Member Password
      Delete Member MFA Phone Number
      Delete Member MFA TOTP
      Unlink Retired Member Email
      Update Self
      Delete Self Password
      Delete Self MFA Phone Number
      Delete Self MFA TOTP
      Unlink Retired Self Email
      Update Member (Deprecated)
      Delete Member MFA Phone Number (Deprecated)
    RBAC
      Is Authorized
      Permissions
    Email Magic Links
      Login or Signup
      Invite
      Authenticate
      Send Discovery Email
      Authenticate Discovery Magic Link
    Email One-time Passcodes (OTPs)
      Login or Signup
      Authenticate OTP
      Send Discovery Email OTP
      Authenticate Discovery Email OTP
    OAuth
      Start OAuth Flow
      Google One Tap
      Authenticate
      Start Discovery OAuth Flow
      Discovery Authenticate
    Session Management
      Get Session
      Authenticate Session
      Revoke Session
      Update Session
      Exchange Session
      Get Tokens
      Revoke Sessions for Member
    SSO
      Start SSO Flow
      Authenticate
      Get SSO Connections
      Discover SSO Connections
      Delete SSO Connection
      Create SAML Connection
      Update SAML Connection
      Update SAML Connection by Metadata URL
      Delete Verification Certificate
      Create OIDC Connection
      Update OIDC Connection
      Create External Connection
      Update External Connection
    Discovery
      List Discovered Organizations
      Create Organization via Discovery
      Exchange Intermediate Session
    Passwords
      Authenticate
      Reset by Email Start
      Reset by Email
      Reset by Existing Password
      Reset by Session
      Strength Check
    • Discovery

      • Authenticate
        Reset by Email Start
        Reset by Email
    SCIM
      Create SCIM Connection
      Update SCIM Connection
      Delete SCIM Connection
      Get SCIM Connection
      SCIM Token Rotation Start
      SCIM Token Rotation Complete
      SCIM Token Rotation Cancel
      Get SCIM Connection Groups
    Multi-Factor Authentication
    • One-Time Passcodes

      • SMS Send
        SMS Authenticate
    • Time-Based One-Time Passcodes

      • TOTP Create
        TOTP Authenticate
    • Recovery Codes

      • Recovery Codes Recover
        Rotate Recovery Codes
        Get Recovery Codes
    Impersonation
      Authenticate

    More Resources

    Cookies & session management
    SWR & caching
    TypeScript
Get support on SlackVisit our developer forum

Contact us

B2B Saas Authentication

/

Frontend SDKs

/

Pre-built UI

/

StytchB2B

/

Callbacks

Callbacks

Callbacks are optional functions for the JavaScript SDK that allow you to do things like take actions in your app or send logs to your backend based on where your user is in the authentication flow.

onEvent

A function that is called when the Stytch client makes a request. The function expects an argument of an event object, and the event object has type and data objects.

{
  "type": "B2B_MAGIC_LINK_EMAIL_LOGIN_OR_SIGNUP",
  "data": {
    "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
    "status_code": 200
  }
},
{
  "type": "B2B_MAGIC_LINK_AUTHENTICATE",
  "data": {
    "method_id": "member-email-test-1dd089b3-8904-47ef-b943-987968e549d4",
    "member_id": "member-test-32fc5024-9c09-4da3-bd2e-c9ce4da9375f",
    "member": { ...Stytch member... },
    "organization": { ...Stytch organization... },
    "session_token": "mZAYn5aLEqKUlZ_Ad9U_fWr38GaAQ1oFAhT8ds245v7Q",
    "session_jwt": "example_jwt",
    "member_session": { ...Stytch member session... },
    "member_authenticated": true,
    "intermediate_session_token": "",
    "mfa_required": {
        "member_options": {
            "mfa_phone_number": "+12025550162"
        },
        "secondary_auth_initiated": null
    },
    "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
    "status_code": 200
  }
},
{
  "type": "B2B_MAGIC_LINK_EMAIL_DISCOVERY_SEND",
  "data": {
    "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
    "status_code": 200
  }
},
{
  "type": "B2B_MAGIC_LINK_DISCOVERY_AUTHENTICATE",
  "data": {
    "email_address": "sandbox@stytch.com",
    "intermediate_session_token": "SeiGwdj5lKkrEVgcEY3QNJXt6srxS3IK2Nwkar6mXD4=",
    "discovered_organizations": [{ ...Stytch organization... }, { ...Stytch organization... }],
    "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
    "status_code": 200
  }
},
{
  "type": "B2B_SSO_START",
  "data": {}
},
{
  "type": "B2B_SSO_AUTHENTICATE",
  "data": {
    "member_id": "member-test-32fc5024-9c09-4da3-bd2e-c9ce4da9375f",
    "member": { ...Stytch member... },
    "organization": { ...Stytch organization... },
    "session_token": "mZAYn5aLEqKUlZ_Ad9U_fWr38GaAQ1oFAhT8ds245v7Q",
    "session_jwt": "example_jwt",
    "member_session": { ...Stytch member session... },
    "member_authenticated": true,
    "intermediate_session_token": "",
    "mfa_required": {
        "member_options": {
            "mfa_phone_number": "+12025550162"
        },
        "secondary_auth_initiated": null
    },
    "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
    "status_code": 200
  }
},
{
  "type": "B2B_DISCOVERY_ORGANIZATIONS_CREATE",
  "data": {
    "member_id": "member-test-32fc5024-9c09-4da3-bd2e-c9ce4da9375f",
    "member": { ...Stytch member... },
    "organization": { ...Stytch organization... },
    "session_token": "mZAYn5aLEqKUlZ_Ad9U_fWr38GaAQ1oFAhT8ds245v7Q",
    "session_jwt": "example_jwt",
    "member_session": { ...Stytch member session... },
    "member_authenticated": true,
    "intermediate_session_token": "",
    "mfa_required": {
        "member_options": {
            "mfa_phone_number": "+12025550162"
        },
        "secondary_auth_initiated": null
    },
    "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
    "status_code": 200
  }
},
{
  "type": "B2B_DISCOVERY_INTERMEDIATE_SESSION_EXCHANGE",
  "data": {
    "member_id": "member-test-32fc5024-9c09-4da3-bd2e-c9ce4da9375f",
    "member": { ...Stytch member... },
    "organization": { ...Stytch organization... },
    "session_token": "mZAYn5aLEqKUlZ_Ad9U_fWr38GaAQ1oFAhT8ds245v7Q",
    "session_jwt": "example_jwt",
    "member_session": { ...Stytch member session... },
    "member_authenticated": true,
    "intermediate_session_token": "",
    "mfa_required": {
        "member_options": {
            "mfa_phone_number": "+12025550162"
        },
        "secondary_auth_initiated": null
    },
    "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
    "status_code": 200
  }
},
{
  "type": "B2B_PASSWORD_AUTHENTICATE",
  "data": {
    "member_id": "member-test-32fc5024-9c09-4da3-bd2e-c9ce4da9375f",
    "member": { ...Stytch member... },
    "organization": { ...Stytch organization... },
    "session_token": "mZAYn5aLEqKUlZ_Ad9U_fWr38GaAQ1oFAhT8ds245v7Q",
    "session_jwt": "example_jwt",
    "member_session": { ...Stytch member session... },
    "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
    "status_code": 200
  }
},
{
  "type": "B2B_PASSWORD_RESET_BY_EMAIL_START",
  "data": {
    "member_id": "member-test-32fc5024-9c09-4da3-bd2e-c9ce4da9375f",
    "member": { ...Stytch member... },
    "organization": { ...Stytch organization... },
    "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
    "status_code": 200
  }
},
{
  "type": "B2B_PASSWORD_RESET_BY_EMAIL",
  "data": {
    "member_id": "member-test-32fc5024-9c09-4da3-bd2e-c9ce4da9375f",
    "member": { ...Stytch member... },
    "organization": { ...Stytch organization... },
    "session_token": "mZAYn5aLEqKUlZ_Ad9U_fWr38GaAQ1oFAhT8ds245v7Q",
    "session_jwt": "example_jwt",
    "member_session": { ...Stytch member session... },
    "member_authenticated": true,
    "intermediate_session_token": "",
    "mfa_required": {
        "member_options": {
            "mfa_phone_number": "+12025550162"
        },
        "secondary_auth_initiated": null
    },
    "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
    "status_code": 200
  }
},
{
  "type": "B2B_PASSWORD_RESET_BY_SESSION",
  "data": {
    "member_id": "member-test-32fc5024-9c09-4da3-bd2e-c9ce4da9375f",
    "member": { ...Stytch member... },
    "organization": { ...Stytch organization... },
    "session_token": "mZAYn5aLEqKUlZ_Ad9U_fWr38GaAQ1oFAhT8ds245v7Q",
    "session_jwt": "example_jwt",
    "member_session": { ...Stytch member session... },
    "member_authenticated": true,
    "intermediate_session_token": "",
    "mfa_required": {
        "member_options": {
            "mfa_phone_number": "+12025550162"
        },
        "secondary_auth_initiated": null
    },
    "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
    "status_code": 200
  },
},
{
  {
    "type": "B2B_SMS_OTP_SEND",
    "data": {
      "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
      "status_code": 200
    }
  },
},
{
  {
    "type": "B2B_SMS_OTP_AUTHENTICATE",
    "data": {
      "member_id": "member-test-32fc5024-9c09-4da3-bd2e-c9ce4da9375f",
      "member": { ...Stytch member... },
      "organization": { ...Stytch organization... },
      "session_token": "mZAYn5aLEqKUlZ_Ad9U_fWr38GaAQ1oFAhT8ds245v7Q",
      "session_jwt": "example_jwt",
      "member_session": { ...Stytch member session... },
      "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
      "status_code": 200
    }
  },
},
{
  {
    "type": "B2B_TOTP_CREATE",
    "data": {
      "member_id": "member-test-32fc5024-9c09-4da3-bd2e-c9ce4da9375f",
      "member": { ...Stytch member... },
      "organization": { ...Stytch organization... },
      "qr_code": "data:image/png;base64,...",
      "recovery_codes": ["abcd-efgh-1234", "ijkl-mnop-5678", "qrst-uvwx-9012"],
      "secret": "X4YCZUQATXPVO46J2EDTZY55NLTQZDQA",
      "totp_registration_id": "member-totp-test-9ed17883-fdfa-4795-9459-cd64a2bf351f",
      "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
      "status_code": 200
    }
  },
},
{
  {
    "type": "B2B_TOTP_AUTHENTICATE",
    "data": {
      "member_id": "member-test-32fc5024-9c09-4da3-bd2e-c9ce4da9375f",
      "member": { ...Stytch member... },
      "organization": { ...Stytch organization... },
      "session_token": "mZAYn5aLEqKUlZ_Ad9U_fWr38GaAQ1oFAhT8ds245v7Q",
      "session_jwt": "example_jwt",
      "member_session": { ...Stytch member session... },
      "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
      "status_code": 200
    }
  },
},
{
  {
    "type": "B2B_RECOVERY_CODES_RECOVER",
    "data": {
      "member_id": "member-test-32fc5024-9c09-4da3-bd2e-c9ce4da9375f",
      "member": { ...Stytch member... },
      "organization": { ...Stytch organization... },
      "session_token": "mZAYn5aLEqKUlZ_Ad9U_fWr38GaAQ1oFAhT8ds245v7Q",
      "session_jwt": "example_jwt",
      "member_session": { ...Stytch member session... },
      "recovery_codes_remaining": 9,
      "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
      "status_code": 200
    }
  }
}

onError

A function that is called when an error occurs. The function expects an argument of an StytchError object, and the StytchError object has a message property.

// Example of an API related error.
  "message": "StytchSDKAPIError: [401] unauthorized_credentials Unauthorized credentials. See https://stytch.com/docs/api/errors/401 for more information. request_id: request-id-test-8e2a9758-713e-49a2-8b62-f9169bbabded",

  // Example of a network related error.
  "message": "SDKAPIUnreachableError: Failed to send magic link Unable to contact the Stytch servers. Are you online?"

  // Example of a schema related error.
  "message": "StytchSDKSchemaError: [400] Request does not match expected schema. email: should be string"

  // Example of an error with using our SDK.
  "message": "StytchSDKUsageError: Invalid call to <METHOD_NAME>"

onEvent

onError