Setting up an SMTP server with add-ons

This tutorial walks you through how to set up an SMTP add-on, to support sending custom emails through PlayFab.


Game Manager will be required, as the SMTP server for the title is set up using an add-on. Read our Game Manager Quickstart if you are unfamiliar with it.

Go to the add-on page and install SMTP

In Game Manager:

  1. Go to Add-ons.
  2. Under the Marketing section, select the SMTP add-on. This will redirect you to the Add-on page.

Marketing-SMTP Add-On button

  1. Select the INSTALL SMTP button.

Configure SMTP

A form should appear with the Host name, Port number, Username, and Password fields.

Game Manager-Add-ons-Install SMTP form

  • Fill out the form with Host name, Port number, Username, and Password for your SMTP server.
  • Select the SAVE SETTINGS button, and the add-on should now be installed.


If your SMTP server requires SSL/TLS, use port 587.


To test this feature, you can use the Gmail SMTP server, provided you have a Gmail account. To use Gmail, fill in the fields as follows:

  • Host name:
  • Port number: 587
  • Username: (your gmail address - e.g., "")
  • Password: (your password)


If you have 2-factor authentication enabled, you will need to create an App password. See Sign in using an App password for more information.

The SMTP add-on is now installed, and will show a green check and message indicating success.

Game Manager-Add-ons-SMTP-Installed