Connecting to Email Services

Revision as of 16:03, 20 August 2018

AWS SES

To create a service for connecting to Amazon SES (Simple Email Service), follow these steps.

• Go to the Services tab in the admin console.
• Click Create.
• Set the Service Type to AWS SES.
• Enter a name and label for the service. Name will be part of the URL for accessing the service via the REST API.
• Go to the Config tab for the new service.
• Enter your AWS access key, secret key, and region.
• Click Create Service to save your new service.
• Go to the API Docs tab in the admin console to test your new service.

Local Email Service

To create a service for connecting to local email, follow these steps.

• Go to the Services tab in the admin console.
• Click Create.
• Set the Service Type to Local Email Service.
• Enter a name and label for the service. Name will be part of the URL for accessing the service via the REST API.
• Click Create Service to save your new service.
• Go to the API Docs tab in the admin console to test your new service.

Note: By default DreamFactory uses 'sendmail' for Local Email Service. You can change this in the .env file by changing the 'MAIL_DRIVER' option. Valid options for 'MAIL_DRIVER' are 'smtp', 'mail', 'sendmail', 'ses', 'mailgun', 'mandrill'. If you choose 'smtp' as Local Email Service driver then see config/mail.php for SMTP configuration. If you choose 'ses', 'mailgun', or 'mandrill' as the driver then see config/services.php for configuration options.

Mailgun Email Service

To create a service for connecting to Mailgun email, follow these steps.

• Go to the Services tab in the admin console.
• Click Create.
• Set the Service Type to Mailgun Email Service.
• Enter a name and label for the service. Name will be part of the URL for accessing the service via the REST API.
• Go to the Config tab for the new service.
• Enter your Mailgun Domain and API Key. Please note that the domain for sandboxed MailGun accounts will not be the full endpoint URL. Only a portion of the mailgun settings is used here, such as: sandboxcea7db2128824e8c9e360d8f5fb6dd09.mailgun.org
• Click Create Service to save your new service.
• Go to the API Docs tab in the admin console to test your new service. If you want to send a simple plain-text e-mail,

{ "to": [ { "name": "John Smith", "email": "john.smith@example.com" } ], "subject": "This is a test e-mail", "body_text": "This is a test e-mail", "from_name": "Jane Doe", "from_email": "jane.doe@example.net", "reply_to_name": "Jane Doe", "reply_to_email": "jane.doe@example.net" }

Mandrill Email Service

To create a service for connecting to Mandrill email, follow these steps.

• Go to the Services tab in the admin console.
• Click Create.
• Set the Service Type to Mandrill Email Service.
• Enter a name and label for the service. Name will be part of the URL for accessing the service via the REST API.
• Go to the Config tab for the new service.
• Enter your Mandrill API Key.
• Click Create Service to save your new service.
• Go to the API Docs tab in the admin console to test your new service.

SMTP Email Service

To create a service for connecting to SMTP email, follow these steps.

• Go to the Services tab in the admin console.
• Click Create.
• Set the Service Type to SMTP Email Service.
• Enter a name and label for the service. Name will be part of the URL for accessing the service via the REST API.
• Go to the Config tab for the new service.
• Enter your Host, Port (default: 587), Encryption (default: tls), Username, Password.
• Click Create Service to save your new service.
• Go to the API Docs tab in the admin console to test your new service.