Function postSendEmail

Remarks

• Verification emails:
  • Have a limited validity period
  • Can be rate-limited per user
  • May be customized based on client_id
  • Support multiple languages based on user preferences
  • Include a secure verification link
  • Are sent from a verified sender address
• Previous verification links are invalidated when new ones are sent.

---

📥 Request

Headers:

• Authorization: Bearer <access_token> (required)
• Content-Type: application/json or application/x-www-form-urlencoded (required)

Body:

• Refer to PostSendEmailRequest

Path Parameters:

• None

Query Parameters:

• None

---

📤 Response

• 201 Created – Verification email successfully sent.

---

❗ Errors

Status Code	Meaning	When it Happens
400	Bad Request	Missing or invalid parameters
401	Unauthorized	Missing or invalid authentication token
404	Not Found	User not found
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Unexpected error

Error Response Format

{
  "error": "Detailed error message here"
}
Copy

---

📦 Examples

📥 Auth0 Request

POST /users/verification-email
{
 "provider": "auth0-user",
 "userId": "exampleUserId",
 "clientId": "client_xyz"
}
Copy

📥 Cognito Request

POST /users/verification-email
{
 "provider": "cognito-user",
 "userId": "cognitoUser@email.com",
 "clientId": "client_xyz"
}
Copy

📤 Response Example

{}
Copy

---