Skip to main content

Authorization

Google​

In order to send an email from a Google account, you'll need to use an application specific password.

Create an Application Specific Password​

  1. Go to your Google Account.

  1. Select Security under the side bar. Under "Signing in to Google," select App Passwords. You may be asked to log in again.

If you don’t have this option, it might be because:

  • 2-Step Verification is not set up for your account.
  • 2-Step Verification is only set up for security keys.
  • Your account is through work, school, or other organization.
  • You turned on Advanced Protection.
  1. At the bottom, click Select app and Custom. Name the app Shipyard or something easy to remember. Click Generate.

  1. On the following screen, copy the app password, shown with a yellow background, to a secure location. This is the password that you'll need to use when sending emails from your Google account via Shipyard.

  1. Click Done once you've saved the password. You'll never be able to see this password again.

Provide Inputs on Shipyard​

We recommend the following settings for successfully sending an email with Google.

VariableValue
Send MethodTLS
SMTP Hostsmtp.gmail.com
SMTP Port587
UsernameYour Google Account Email
PasswordYour Application Specific Password

SendGrid​

In order to send an email from SendGrid, you'll need to use a Sender Identity and an API Key.

Create a Sender Identity​

  1. Navigate to the Sender Authentication page of your SendGrid account.

  1. Follow the on-page instructions to either authenticate your domain, or verify a single sender address.

Create an API Key​

  1. Navigate to the API Key page of your SendGrid account.

  1. Click Create API Key.

  2. Name your API Key and select the level of access. At minimum, you will need Full Access to Mail Send. Click Create & View once finished.

  1. On the following screen, copy the API Key to a secure location. This is the password that you'll need to use when sending emails from your SendGrid account via Shipyard.

Provide Inputs on Shipyard​

We recommend the following settings for successfully sending an email with Google.

VariableValue
Send MethodTLS
SMTP Hostsmtp.sendgrid.net
SMTP Port587
Usernameapikey
Password<your-api-key>

NOTE: The sender address should be the literal text apikey. The Password should be your actual api key (SG.value) NOT base64 encoded.

Outlook (Personal)​

Provide Inputs on Shipyard​

We recommend the following settings for successfully sending an email with Outlook.

VariableValue
Send MethodTLS
SMTP Hostsmtp.office365.com
SMTP Port587
UsernameYour Microsoft Account Email
PasswordYour Microsoft Account Password

NOTE: It's possible that you will run into authentication issues because Microsoft sees the attempted login as suspicious. You'll need to let Microsoft know to allow the login attempt.

Outlook (Office365 Business)​

Enable SMTP Authentication​

Follow this guide to effectively allow for sending emails via SMTP.

Provide Inputs on Shipyard​

We recommend the following settings for successfully sending an email with Outlook.

VariableValue
Send MethodTLS
SMTP Hostsmtp.office365.com
SMTP Port587
UsernameYour Microsoft Account Email
PasswordYour Microsoft Account Password

NOTE: It's possible that you will run into authentication issues because Microsoft sees the attempted login as suspicious. You'll need to let Microsoft know to allow the login attempt.

Amazon SES​

Create an Identity​

  1. Navigate to the SES console within your AWS account.

  1. Click Create Identity

  1. Create an identity by verifying a specific email address. You can also verify a domain if that suits your setup better.

  1. Navigate to your email and click the confirmation link to confirm that you have access to the right email.

Create SMTP Credentials​

  1. Navigate to your Amazon SES Account dashboard and scroll to the bottom where it says Simple Mail Transfer Protocol (SMTP) settings.

  1. Click Create SMTP credentials.
  2. Customize the IAM Username and click Create at the bottom.

  1. Store the SMTP credentials somewhere secure.

Provide Inputs on Shipyard​

We recommend the following settings for successfully sending an email with Amazon SES.

VariableValue
Send MethodTLS
SMTP Hostemail-smtp.us-west-2.amazonaws.com
SMTP Port587
UsernameSMTP Username
PasswordSMTP Password

NOTE: If your SES instance is running in a region other than us-west-2, you'll want to use that region in the SMTP Host.