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

# Send email verification (code or link based on config)

> Send email verification using the method configured in auth settings (verifyEmailMethod). When method is 'code', sends a 6-digit numeric code. When method is 'link', sends a browser verification link that goes through an InsForge backend endpoint first. Prevents user enumeration by returning success even if email doesn't exist.



## OpenAPI

````yaml https://raw.githubusercontent.com/InsForge/InsForge/main/openapi/auth.yaml post /api/auth/email/send-verification
openapi: 3.0.3
info:
  title: Insforge Authentication API
  version: 2.0.0
  description: Authentication endpoints with separated auth and profile tables
servers: []
security: []
paths:
  /api/auth/email/send-verification:
    post:
      tags:
        - Client
      summary: Send email verification (code or link based on config)
      description: >-
        Send email verification using the method configured in auth settings
        (verifyEmailMethod). When method is 'code', sends a 6-digit numeric
        code. When method is 'link', sends a browser verification link that goes
        through an InsForge backend endpoint first. Prevents user enumeration by
        returning success even if email doesn't exist.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - email
              properties:
                email:
                  type: string
                  format: email
                  example: user@example.com
                redirectTo:
                  type: string
                  format: uri
                  description: >-
                    Used for link-based email verification. The email link
                    always opens an InsForge backend endpoint first; after the
                    token is verified, InsForge redirects the browser to this
                    URL. This URL must be included in allowedRedirectUrls.
                    Recommended: use your app's sign-in page.
      responses:
        '202':
          description: >-
            Verification email sent (if email exists). Message varies based on
            configured method.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                    example: >-
                      If your email is registered, we have sent you a
                      verification code/link. Please check your inbox.
        '400':
          description: Invalid request

````