> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SignupId

> Describe los hooks y métodos disponibles para personalizar la pantalla `signup-id` de Universal Login.

La pantalla `signup-id` solicita el identificador del usuario —como el correo electrónico, el username o el número de teléfono— como primer paso de un flujo de registro de varios pasos. También admite el registro federado mediante conexiones sociales o empresariales.

<Frame>
  <img style={{maxHeight:"400px"}} src="https://mintcdn.com/translations/MV7tE-x71x8RWRES/docs/images/cdy7uua7fh8z/5lzGYj0k4VcxvPCBYH37SO/ebd291cc0dbd673a70f93530f724bf65/Signup_ID.png?fit=max&auto=format&n=MV7tE-x71x8RWRES&q=85&s=f8668b2501b5d9fa4bfb02a20425e9f6" alt="Signup ID" width="480" height="632" data-path="docs/images/cdy7uua7fh8z/5lzGYj0k4VcxvPCBYH37SO/ebd291cc0dbd673a70f93530f724bf65/Signup_ID.png" />
</Frame>

<div id="import">
  ## Importación
</div>

Cada pantalla tiene su propio conjunto de hooks y métodos. El SDK admite **importación parcial** e **importación desde la raíz** para cada pantalla.

* La importación parcial le permite incluir solo el código que necesita para su caso de uso concreto.
* La importación desde la raíz le permite cargar todas las pantallas desde un único paquete, lo que resulta útil cuando necesita una compilación unificada para gestionar todas las pantallas posibles.

```jsx Import Example theme={null}
// importación desde la raíz
import { useSignupId } from '@auth0/auth0-acul-react';

// importación parcial
import {
  useSignupId,
  // Hooks de contexto
  useUser,
  useTenant,
  useBranding,
  useClient,
  useOrganization,
  usePrompt,
  useScreen,
  useTransaction,
  useUntrustedData,
  // Hooks comunes
  useCurrentScreen,
  useAuth0Themes,
  useErrors,
  // Hooks de utilidad
  useChangeLanguage,
  useSignupIdentifiers,
  useUsernameValidation,
  // Métodos
  signup,
  federatedSignup,
  pickCountryCode,
} from '@auth0/auth0-acul-react/signup-id';

function SignupIdForm() {
  const { signup } = useSignupId();
  return (
    <button onClick={() => signup({ email: 'user@example.com' })}>
      Continue
    </button>
  );
}
```

<div id="context-hooks">
  ## Hooks de contexto
</div>

Hooks con alcance de pantalla que proporcionan acceso de solo lectura a los datos de contexto de Auth0 en la pantalla `signup-id`. Impórtelos desde `@auth0/auth0-acul-react/signup-id`.

<ParamField body="useBranding" type={<span>() =&gt; <a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/BrandingMembers">BrandingMembers</a></span>}>
  Este hook proporciona configuraciones de marca, como el logotipo, los colores y los ajustes del tema que se muestran en la pantalla `signup-id`.

  ```jsx Example theme={null}
  import { useBranding } from '@auth0/auth0-acul-react/signup-id';
  function CustomTheme() {
    const branding = useBranding();
  }
  ```
</ParamField>

<ParamField body="useClient" type={<span>() =&gt; <a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/ClientMembers">ClientMembers</a></span>}>
  Este hook proporciona datos relacionados con el cliente, como `id`, `name` y `logoUrl`, para la pantalla `signup-id`.

  ```jsx Example theme={null}
  import { useClient } from '@auth0/auth0-acul-react/signup-id';
  function AppInfo() {
    const client = useClient();
  }
  ```
</ParamField>

<ParamField body="useOrganization" type={<span>() =&gt; <a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/OrganizationMembers">OrganizationMembers</a></span>}>
  Este hook proporciona información sobre la Organización del usuario si el registro está asociado a una Organización. Devuelve `null` cuando no hay contexto de Organización.

  ```jsx Example theme={null}
  import { useOrganization } from '@auth0/auth0-acul-react/signup-id';
  function OrgSelector() {
    const organization = useOrganization();
    if (!organization) {
      return <p>Sin contexto de organización</p>;
    }
  }
  ```
</ParamField>

<ParamField body="usePrompt" type={<span>() =&gt; <a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/PromptMembers">PromptMembers</a></span>}>
  Este hook contiene datos sobre la pantalla actual en el flujo de autenticación.

  ```jsx Example theme={null}
  import { usePrompt } from '@auth0/auth0-acul-react/signup-id';
  function FlowInfo() {
    const prompt = usePrompt();
  }
  ```
</ParamField>

<ParamField body="useScreen" type={<span>() =&gt; <a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/ScreenMembersOnSignupId">ScreenMembersOnSignupId</a></span>}>
  Este hook contiene detalles específicos de la pantalla `signup-id`, incluida su configuración y contexto.

  ```jsx Example theme={null}
  import { useScreen } from '@auth0/auth0-acul-react/signup-id';
  function ScreenDebug() {
    const screen = useScreen();
  }
  ```
</ParamField>

<ParamField body="useTenant" type={<span>() =&gt; <a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/TenantMembers">TenantMembers</a></span>}>
  Este hook contiene datos relacionados con el inquilino, como `id` y los metadatos asociados.

  ```jsx Example theme={null}
  import { useTenant } from '@auth0/auth0-acul-react/signup-id';
  function TenantInfo() {
    const tenant = useTenant();
  }
  ```
</ParamField>

<ParamField body="useTransaction" type={<span>() =&gt; <a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/TransactionMembersOnSignupId">TransactionMembersOnSignupId</a></span>}>
  Este hook proporciona datos específicos de la transacción para la pantalla `signup-id`, como las conexiones activas y el estado actual del flujo.

  ```jsx Example theme={null}
  import { useTransaction } from '@auth0/auth0-acul-react/signup-id';
  function TransactionInfo() {
    const transaction = useTransaction();
  }
  ```
</ParamField>

<ParamField body="useUntrustedData" type={<span>() =&gt; <a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/UntrustedDataMembers">UntrustedDataMembers</a></span>}>
  Este hook proporciona acceso a los datos no confiables que se pasan a la pantalla, como un correo electrónico o un username rellenado previamente a partir de parámetros de URL.

  ```jsx Example theme={null}
  import { useUntrustedData } from '@auth0/auth0-acul-react/signup-id';
  function PrefilledForm() {
    const untrustedData = useUntrustedData();
  }
  ```
</ParamField>

<ParamField body="useUser" type={<span>() =&gt; <a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/UserMembers">UserMembers</a></span>}>
  Este hook ofrece información del usuario actual, incluidos `username`, `email` y los métodos de autenticación disponibles.

  ```jsx Example theme={null}
  import { useUser } from '@auth0/auth0-acul-react/signup-id';
  function UserProfile() {
    const user = useUser();
  }
  ```
</ParamField>

<ParamField body="useSignupId" type={<a href="/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/SignupIdMembers">SignupIdMembers</a>}>
  Este hook devuelve todos los métodos y el contexto disponibles en la pantalla `signup-id`.
</ParamField>

<div id="methods">
  ## Métodos
</div>

<ParamField body="federatedSignup" type="Promise<void>">
  Este método inicia el registro mediante un proveedor de identidad federado, como Google o GitHub.

  ```jsx Example theme={null}
  import { useSignupId } from '@auth0/auth0-acul-react/signup-id';

  function SocialButton() {
    const { federatedSignup } = useSignupId();
    return (
      <button onClick={() => federatedSignup({ connection: 'google-oauth2' })}>
        Sign up with Google
      </button>
    );
  }
  ```

  **Parámetros del método**

  <Expandable title="Parámetros">
    <ParamField body="options">
      [FederatedSignupOptions](/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/FederatedSignupOptions).
    </ParamField>

    <ParamField body="connection" type="string" required>
      El nombre de la conexión social o empresarial que se va a usar (por ejemplo, `google-oauth2`, `github`).
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="pickCountryCode" type="Promise<void>">
  Este método abre el selector de código de país para introducir el número de teléfono durante el registro.

  ```jsx Example theme={null}
  import { useSignupId } from '@auth0/auth0-acul-react/signup-id';

  function CountryCodePicker() {
    const { pickCountryCode } = useSignupId();
    return (
      <button onClick={() => pickCountryCode()}>
        Select Country Code
      </button>
    );
  }
  ```

  **Parámetros del método**

  <Expandable title="Parámetros">
    <ParamField body="options">
      [CustomOptions](/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/CustomOptions).
    </ParamField>

    <ParamField body="[`key`: `string`]" type="&#x22;string&#x22; | &#x22;number&#x22; | &#x22;boolean&#x22; | &#x22;undefined&#x22;">
      Campos personalizados adicionales con el prefijo `ulp-` (por ejemplo, `'ulp-custom-field'`).
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="signup" type="Promise<void>">
  Este método envía el identificador del usuario para pasar al siguiente paso del flujo de registro.

  ```jsx Example theme={null}
  import { useSignupId } from '@auth0/auth0-acul-react/signup-id';

  function SignupIdForm() {
    const { signup } = useSignupId();
    return (
      <button onClick={() => signup({ email: 'user@example.com' })}>
        Continue
      </button>
    );
  }
  ```

  **Parámetros del método**

  <Expandable title="Parámetros">
    <ParamField body="options">
      [SignupOptions](/es/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/SignupOptions).
    </ParamField>

    <ParamField body="email" type="string">
      La dirección de correo electrónico del usuario.
    </ParamField>

    <ParamField body="username" type="string">
      El username de la cuenta nueva, si la conexión lo requiere.
    </ParamField>

    <ParamField body="phone" type="string">
      El número de teléfono del usuario, si la conexión lo requiere.
    </ParamField>

    <ParamField body="captcha?" type="string">
      Valor de captcha obligatorio cuando la detección de bots está habilitada en el inquilino.
    </ParamField>

    <ParamField body="[`key`: `string`]" type="&#x22;string&#x22; | &#x22;number&#x22; | &#x22;boolean&#x22; | &#x22;undefined&#x22;">
      Campos personalizados adicionales con el prefijo `ulp-` (por ejemplo, `'ulp-custom-field'`).
    </ParamField>
  </Expandable>
</ParamField>

<div id="commonutility-hooks">
  ## Hooks comunes/de utilidad
</div>

<ParamField body={<a href="/es/docs/libraries/acul/react-sdk/API-Reference/Hooks/useAuth0Themes">useAuth0Themes</a>} type="Hooks">
  Este hook obtiene las opciones del tema actual con la configuración aplanada del contexto de marca.
</ParamField>

<ParamField body={<a href="/es/docs/libraries/acul/react-sdk/API-Reference/Hooks/useChangeLanguage">useChangeLanguage</a>} type="Hooks">
  Este hook devuelve una función para cambiar el idioma mostrado en la pantalla actual de ACUL.
</ParamField>

<ParamField body={<a href="/es/docs/libraries/acul/react-sdk/API-Reference/Hooks/useCurrentScreen">useCurrentScreen</a>} type="Hooks">
  Este hook obtiene el contexto y el estado de la pantalla actual.
</ParamField>

<ParamField body={<a href="/es/docs/libraries/acul/react-sdk/API-Reference/Hooks/useErrors">useErrors</a>} type="Hooks">
  Este hook lee y administra los errores del servidor, del cliente y del desarrollador en la pantalla.
</ParamField>

<ParamField body={<a href="/es/docs/libraries/acul/react-sdk/API-Reference/Hooks/useSignupIdentifiers">useSignupIdentifiers</a>} type="Hooks">
  Este hook devuelve los tipos de identificadores de registro disponibles (email, username, phone) configurados para la conexión.
</ParamField>

<ParamField body={<a href="/es/docs/libraries/acul/react-sdk/API-Reference/Hooks/useUsernameValidation">useUsernameValidation</a>} type="Hooks">
  Este hook valida el username del usuario según los requisitos de la política de username del inquilino.
</ParamField>
