Initiate email verification

View as Markdown
POST
/users/{user_id}/emails/{identifier_id}/verify/link

Generates a signed, time-bound verification link for the specified email address and sends it to the user. Once verified, the email becomes eligible for authentication and secure communication.

Authorization

API-Key
headerX-API-KEY<token>

MonoCloud APIs require authentication with an API key. Retrieve your key from the Tenant Settings section of the MonoCloud dashboard and include it in the request header as: X-API-Key: <your_api_key>

Path Parameters

user_id*string

The unique identifier of the user.

identifier_id*string

The unique identifier of the email address.

Formatuuid

Request Body

application/json

The request payload used to initiate email verification.

TypeScript Definitions

Use the request body type in TypeScript.

Verify Email Request: Used to generate an email verification link.

Response Body

200

application/json

The email verification link was generated successfully

TypeScript Definitions

Use the response body type in TypeScript.

Verify Email Response: Returns the delivery status of the verification email.

Errors

401Unauthorized
403Forbidden

curl -X POST "https://your-domain.us.monocloud.com/api/users/WUgDGqaqzqkRmsgd3PFAT/emails/4b7a790b-b28b-4877-8a08-ab4e668231d1/verify/link" \  -H "X-API-KEY: <token>" \  -H "Content-Type: application/json" \  -d '{}'
{  "expires_at": 0,  "email_sent": true}
© 2026 MonoCloud. All rights reserved.