mtx::requests::RequestEmailToken struct

Request payload for POST /_matrix/client/r0/{register,account/password}/email/requestToken

The homeserver should validate the email itself, either by sending a validation email itself or by using a service it has control over.

Public variables

std::string client_secret
Required. A unique string generated by the client, and used to identify the validation attempt. It must be a string consisting of the characters [0-9a-zA-Z.=_-]. Its length must not exceed 255 characters and it must not be empty.
std::string email
Required. The email address to validate.
int send_attempt
Required. The server will only send an email if the send_attempt is a number greater than the most recent one which it has seen, scoped to that email + client_secret pair. This is to avoid repeatedly sending the same email in the case of request retries between the POSTing user and the identity server. The client should increment this value if they desire a new email (e.g. a reminder) to be sent. If they do not, the server should respond with success but not resend the email.