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

# Send Registration Email

> Initiate registration by sending verification code to user's email

## Overview

First step of user registration. Sends a verification code to the user's email address. The user will receive an email with a 6-digit code that must be verified in the next step.

This creates a temporary contact verification record that expires after a set time period (typically 10-15 minutes).

## Request

### Body

<ParamField body="email" type="string" required>
  User's email address for registration

  **Format**: Valid email

  **Example**: `hello@example.com`
</ParamField>

## Response

<ResponseField name="contactVerificationId" type="string">
  Verification ID to use in subsequent steps

  Store this value - required for email verification

  **Example**: `US_100a99cf-f4d3-4fa1-9be9-2e9828b20ebb`
</ResponseField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://dev.api.baanx.com/v1/auth/register/email/send" \
    -H "x-client-key: your-client-key" \
    -H "Content-Type: application/json" \
    -d '{"email": "hello@example.com"}'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://dev.api.baanx.com/v1/auth/register/email/send', {
    method: 'POST',
    headers: {
      'x-client-key': 'your-client-key',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      email: 'hello@example.com'
    })
  });

  const { contactVerificationId } = await response.json();
  sessionStorage.setItem('contactVerificationId', contactVerificationId);
  console.log('Verification email sent');
  ```
</CodeGroup>

## Next Steps

<Card title="Verify Email Code" href="/api-reference/auth/register-email-verify">
  Verify the code received by email to create user account
</Card>