Sample code for 30+ languages & platforms
Objective-C Requires Chilkat v11.0.0+

Gmail SMTP: Send with an App Password on Port 587

See more SMTP Examples

Send through Gmail on port 587 using required STARTTLS and an app password. This page replaces the former less-secure password-authentication instructions. Port 465 uses implicit TLS instead.

This sends a real email. Use a recipient you control and the account's authorized sender identity. Gmail sending limits still apply. For OAuth2, use the token-based sending example.

Use an account-specific app password generated after enabling 2-Step Verification, loaded from protected configuration. A normal Google password will not work. App passwords may be unavailable under account or Workspace policy; OAuth2 is preferred. Changing the Google account password revokes app passwords. The obsolete less-secure-apps switch is not a setup option. Google app-password requirements.

See the Gmail SMTP, IMAP, and POP3 guide for current authentication choices and Gmail-specific examples.

Reference documentation

Chilkat Objective-C Downloads

Objective-C
#import <NSString.h>
#import <CkoMailMan.h>
#import <CkoEmail.h>

BOOL success = NO;

//  Assumes Chilkat is unlocked. See Global Unlock Sample.

NSString *mailbox = @"user@example.com";
CkoMailMan *mailman = [[CkoMailMan alloc] init];
mailman.SmtpHost = @"smtp.gmail.com";
mailman.SmtpPort = [NSNumber numberWithInt:587];
mailman.SmtpSsl = NO;
mailman.StartTLS = YES;
mailman.RequireSslCertVerify = YES;
//  Alternative: port 465 with SmtpSsl=true and StartTLS=false (implicit TLS).
mailman.SmtpUsername = mailbox;
//  Load the app password from protected configuration.
mailman.SmtpPassword = @"YOUR_16_CHARACTER_APP_PASSWORD";

CkoEmail *email = [[CkoEmail alloc] init];
email.From = mailbox;
email.Subject = @"Sample message";
email.Body = @"This message was sent through Gmail SMTP using an app password.";
success = [email AddTo: @"Recipient" emailAddress: @"recipient@example.net"];
if (success != YES) {
    NSLog(@"%@",@"Could not add the recipient.");
    return;
}

//  This sends a real message. Replace the recipient with an address you control.
success = [mailman SendEmail: email];
if (success != YES) {
    [mailman CloseSmtpConnection];
    NSLog(@"%@",@"SMTP send failed. Check the app password, mailbox, recipient, and Gmail sending limits.");
    //  Inspect LastErrorText privately if needed; do not publish authentication/session logs.
    //  A lost connection after DATA can leave acceptance uncertain. Avoid blindly retrying.
    return;
}

success = [mailman CloseSmtpConnection];
if (success != YES) {
    NSLog(@"%@",@"Gmail accepted the message, but closing the connection failed. Do not resend it.");
    return;
}

NSLog(@"%@",@"Gmail accepted the message for delivery.");