Skip to content

Create Email Confirmation


A confirmation email message includes a special link the user clicks to confirm their email address. When the link is clicked and the link is not expired, the user status changes from EMAIL_CONFIRMATION_PENDING to ENABLED. The email message delivered to the user is created from the Confirmation template located in Messaging > Emails in Backendless Console. There are scenarios when the link needs to be generated in your application logic, for instance, if you need to send it out via text message or if you need to generate the confirmation email dynamically.


[Backendless.shared.userService createEmailConfirmationWithIdentity:(NSString *)identityValue responseHandler:^(NSString *)responseHandler errorHandler:^(Fault *)errorHandler];
Backendless.shared.userService.createEmailConfirmation(identityValue: String, responseHandler: ((String) -> Void)!, errorHandler: ((Fault) -> Void)!)


Argument                Description
identityValue Value in a column marked as identity in the Users table. By default a Backendless application has email as the identity column. In that case the parameter for the API should be the email address of a user. Can be a string value or a number.
responseHandler Handles successful result of an asynchronous call.
errorHandler Handles fault result of an asynchronous call.

Return Value

An object containing confirmation URL as a string value.


The example below creates a new confirmation email and sends it to the "".

[Backendless.shared.userService createEmailConfirmationWithIdentity:@"" responseHandler:^(NSString *response) {
    // handle response
} errorHandler:^(Fault *fault) {
    // handle error
Backendless.shared.userService.createEmailConfirmation(identity: "", responseHandler: { response in
    // handle response
}, errorHandler: { fault in
    // handle error