Send Discovery Email Magic Link

import { useStytchB2BClient } from '@stytch/react/b2b';

export const DiscoveryLogin = () => {
  const stytch = useStytchB2BClient();

  const sendDiscoveryEmail = () => {
    stytch.magicLinks.email.discovery.send({
      email_address: 'user@example.com',
    });
  };

  return <button onClick={sendDiscoveryEmail}>Send discovery email</button>;
};

import { useStytchB2BClient } from '@stytch/react/b2b';

export const DiscoveryLogin = () => {
  const stytch = useStytchB2BClient();

  const sendDiscoveryEmail = () => {
    stytch.magicLinks.email.discovery.send({
      email_address: 'user@example.com',
    });
  };

  return <button onClick={sendDiscoveryEmail}>Send discovery email</button>;
};

import { useStytchB2BClient } from '@stytch/react/b2b';

export const DiscoveryLogin = () => {
  const stytch = useStytchB2BClient();

  const sendDiscoveryEmail = () => {
    stytch.magicLinks.email.discovery.send({
      email_address: 'user@example.com',
    });
  };

  return <button onClick={sendDiscoveryEmail}>Send discovery email</button>;
};

magicLinks.email.discovery.send wraps the send discovery email endpoint. After the user clicks the discovery link, use the authenticate discovery magic link method to complete authentication.

Parameters

email_address

string

required

The email address to send the discovery Magic Link to.

discovery_redirect_url

string

The URL that the end user clicks from the discovery Email Magic Link. This URL should be an endpoint in your application that displays the user’s discovered organizations and allows them to authenticate into one.If this value is not passed, the default discovery redirect URL that you set in your Dashboard is used. If you have not set a default discovery redirect URL, an error is returned.

Use a custom template for discovery emails. By default, it will use your default email template. The template must be from Stytch’s built-in customizations or a custom HTML email for Discovery - Login.

locale

string

Used to determine which language to use when sending the user this delivery method. Parameter is an IETF BCP 47 language tag, e.g. “en”.Supported languages are English (“en”), Spanish (“es”), French (“fr”) and Brazilian Portuguese (“pt-br”); if no value is provided, the copy defaults to English.

Response

request_id

string

Globally unique UUID that is returned with every API call. This value is important to log for debugging purposes; we may ask for this value to help identify a specific API call when helping you debug an issue.

status_code

number

The HTTP status code of the response. Stytch follows standard HTTP response status code patterns, e.g. 2XX values equate to success, 3XX values are redirects, 4XX are client errors, and 5XX are server errors.

⌘I

​Parameters

​Response

Parameters

Response