---
title: "Send verification email (with optional user creation)"
method: POST
path: "/email-verification/send"
tags: ["email-verification"]
---

# Send verification email (with optional user creation)

`POST /email-verification/send`

Send a verification email to the specified email address. If the user does not exist and you provide name, a new user will be created automatically (commissionPlanId is optional - uses default if not provided). For existing users, just provide the email address.

## Request body

- SendVerificationDto
  - `email` string, required — Email address to verify
  - `productCode` string, required — Product code for verification context
  - `userId` number — Optional: User ID if verifying for existing user
  - `name` string — Optional: User name - if provided, will create user if not exists
  - `commissionPlanId` number — Optional: Commission plan ID - if not provided, uses default (first) plan

## Response `200`

Verification email sent successfully (user created if needed)

- EmailVerificationResponseDto
  - `success` boolean, required — Success status
  - `message` string, required — Response message
  - `verificationId` number — Optional: Verification ID
  - `email` string — Optional: Email address
  - `verified` boolean — Optional: Verification status
  - `userId` number — User ID (returned when user exists or is created)
  - `verifiedAt` string, date-time — Optional: Timestamp when email was verified

## Other responses

- `400` — Bad Request - Invalid data, commission plan not found, or no plans exist
- `404` — User not found (provide name to auto-create)
- `409` — Email already verified or email already exists

---

[API](https://skmtc.dev/tonewow/apis/tonewow-database-api.md) · [All operations](https://skmtc.dev/tonewow/apis/tonewow-database-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tonewow/tonewow-database-api/revisions/f36472974ad4/schema)