Documentation Documentation

Outbound Email Configuration

Custom Email Templates

The email templates for the Portal and system messages are located in the portal/email_templates directory. The Tyk Dashboard will need to be restarted for changes to take effect.

Supported email drivers

  • SMTP
  • Mandrill
  • Sendgrid
  • Mailgun
  • AmazonSES

To get email set up for your installation, add the following to your tyk_analytics.conf file:

"email_backend": {
  "enable_email_notifications": true,
  "code": "{PROVIDER-NAME}",
  "settings": {
    // Client provider specific settings go here. You can find the specific field described below 
  "default_from_email": "[email protected]",
  "default_from_name": "Jeffrey (The Dude) Lebowski"


Available from Tyk Dashboard version 1.7

"code": "smtp",
"settings": {
  "SMTPUsername": "[email protected]",
  "SMTPPassword": "examplepassword",
  "SMTPAddress": ""


Available from Tyk Dashboard version 1.8

If SMTPUsername or SMTPPassword is omitted, Tyk assumes that authentication is not required for your SMTP server. When starting up and initialising the email driver, the Dashboard should output a log message as follows:

[May  6 13:46:41]  INFO email: initializing SMTP email driver
[May  6 13:46:41]  INFO email: SMTPUsername and/or SMTPPassword not set - smtp driver configured for no-auth
[May  6 13:46:41]  INFO email: SMTP email driver initialized


"code": "mandrill",
"settings": {
  "ClientKey": "xxxxxxxxx"


"code": "sendgrid",
"settings": {
  "ClientKey": "xxxxxxxxx"


"code": "mailgun",
"settings": {
  "Domain": "KEY",
  "PrivateKey": "KEY",
  "PublicKey": "KEY"

Amazon SES

"code": "amazonses",
"settings": {
  "Endpoint": "Endpoint",
  "AccessKeyId": "Access-key",
  "SecretAccessKey": "KEY"

Customise your Key Approval Emails

Editing the Email Body

  1. Select Settings from your Dashboard > Portal Management
  2. From the “API Key approval email” section, select “Enable custom approval email”, and edit the API Key email body.


Add an image or logo to the Key Approval Email

  1. Select “Enable custom approval email” as above.
  2. In the “API Key email body copy” field, enter <img src="[LINK TO IMAGE]"/>


NOTE: The LINK TO IMAGE must be a publicly hosted resource.

In an On-Premises installation you have full access to the HTML template, allowing you further customisation.

Portal Manager Email Settings


  1. Select Settings from your Dashboard > Portal Management
  2. From the Portal manager email address section, enter the email address of the person responsible for approving your developer API subscription requests. See Portal Key Requests for more details.