Email - Authorization

Email templates no longer require credentials to be provided. All emails will originate from `alli@pmg.com`. If you have your own email service, and would like to override the existing service with your own, please reach out to the Workflows team for more information. This is not recommended/required.

Example: Alli Workflows is the Sender Name, but you cannot override the sender address from alli@pmg.com.

 

Google

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

Create an Application Specific Password

1. Go to your .

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.
3. 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.

|Variable|Value|
|:--|:--|
|Send Method|TLS|
|SMTP Host|smtp.gmail.com|
|SMTP Port|587|
|Username|Your Google Account Email|
|Password|Your 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 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 page of your SendGrid account.

1. Click Create API Key.

1. 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.

|Variable|Value|
|:--|:--|
|Send Method|TLS|
|SMTP Host|smtp.sendgrid.net|
|SMTP Port|587|
|Username|apikey|
|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.

|Variable|Value|
|:--|:--|
|Send Method|TLS|
|SMTP Host|smtp.office365.com|
|SMTP Port|587|
|Username|Your Microsoft Account Email|
|Password|Your 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 to effectively allow for sending emails via SMTP.

Provide Inputs on Shipyard

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

|Variable|Value|
|:--|:--|
|Send Method|TLS|
|SMTP Host|smtp.office365.com|
|SMTP Port|587|
|Username|Your Microsoft Account Email|
|Password|Your 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.

1. 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.

|Variable|Value|
|:--|:--|
|Send Method|TLS|
|SMTP Host|email-smtp.us-west-2.amazonaws.com|
|SMTP Port|587|
|Username|SMTP Username|
|Password|SMTP 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.