--- title: "SMTP Mailer" slug: "smtp-mailer" updated: 2025-04-17T19:16:52Z published: 2025-04-17T19:16:52Z canonical: "docs.processmaker.com/smtp-mailer" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.processmaker.com/llms.txt > Use this file to discover all available pages before exploring further. # SMTP Mailer ## SMTP Mailer Driver Settings Simple Mail Transfer Protocol (SMTP) is an internet standard communication protocol for electronic email transmission. Configure the [SMTP email server](https://sendgrid.com/blog/what-is-an-smtp-server/) to use a secure or insecure connection. ## Configure SMTP Mailer Driver Settings **Permissions** Your user account or group membership must have the "Settings: Update Settings" permission to edit email server settings unless your user account has the **Make this user a Super Admin** setting selected. See the [Settings](/v1/docs/permission-descriptions-for-users-and-groups#settings) permissions or ask your Administrator for assistance. > [!NOTE] > **Gmail Best Practice** > > If configuring SMTP with a Gmail service, as a best practice, configure the **User Account** setting with the same value as in the **Sender Email** setting. To configure a Simple Mail Transfer Protocol (SMTP) mailer driver, the following information is needed: - SMTP server host name - SMTP server port - SMTP account username and password Configure the following SMTP settings as necessary: 1. [Create a new email server configuration](/v1/docs/email-default-settings#create-a-new-email-server-configuration). The settings for the new email server display. By default **smtp** is selected as the mailer driver and the settings for the SMTP email server display. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/26fd9e4a-88fd-4663-af2e-ae8231e63250.png) 2. Click the **Edit** ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/b3630a8e-2828-4a12-a117-278a547a47b7.png) icon for the **Sender Email** setting. The **Sender Email** screen displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/66f21434-1ae4-4d95-a456-37c360d0cc31.png) 3. Enter the email address that this server uses to send emails, and then click **Save**. 4. Click the **Edit** ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/b3630a8e-2828-4a12-a117-278a547a47b7.png) icon for the **Sender Name** setting. The **Sender Name** screen displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/b1208155-a124-45c4-8ee6-77b9d1eb984e.png) 5. Enter the person or company name that sends the email, and then click **Save**. 6. Click the **Edit** ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/b3630a8e-2828-4a12-a117-278a547a47b7.png) icon for the **Server Host** setting. The **Server Host** screen displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/27921f05-b2f0-400e-9185-6d1702a1960b.png) 7. Enter the host SMTP application or service, and then click **Save**. 8. Click the **Edit** ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/b3630a8e-2828-4a12-a117-278a547a47b7.png) icon for the **Server Port** setting. The **Server Port** screen displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/dc170bef-dc1a-41ef-9f4f-cba15d515bc4.png) 9. Enter the port number that this email server uses, and then click **Save**. 10. Click the **Edit** ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/b3630a8e-2828-4a12-a117-278a547a47b7.png) icon for the **Use secure connection** setting. The **Use secure connection** screen displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/fd42a88c-a55b-40ef-834b-c24b81f399bf.png) 11. Select one of the following connection protocols options that this SMTP email server uses to send and receive emails: - **no:** Use no secure connection. - **tls:** Use Transport Layer Security (TLS). This is the default option. - **ssl:** Use Secure Sockets Layer (SSL) protocol. 12. Click the **Edit** ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/b3630a8e-2828-4a12-a117-278a547a47b7.png) icon for for the **User Account** setting. The **User Account** screen displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/f5507593-f7a2-4ce9-b85d-ec583cf84692.png) 13. Enter an active user account the SMTP email server uses, and then click **Save**. 14. Click the **Edit** ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/b3630a8e-2828-4a12-a117-278a547a47b7.png) icon for the **User Password** setting. The **User Password** screen displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/a5e7314c-4ef0-4a38-b800-dd531d64b60a.png) 15. Enter the password corresponding with the user account that this SMTP email server uses. The password is masked by default. Optionally, click the **View Password** icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/51d03d77-ed67-4a13-acae-09139110df56.png) to view the entered password; thereafter, click the **Hide Password** icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/31b7ea53-7c53-4a1c-9def-a155ad3c01a3.png) to hide the entered password. 16. Click **Save**. 17. [Optionally, send a test email to ensure that the email server configuration functions correctly](/v1/docs/email-default-settings#send-a-test-email-using-an-email-server-configuration). ## Example SMTP Mail Server Configuration Consider the following example for an SMTP mail server configuration: - **Mailer driver:** `smtp` - **Sender Email:** `RileySmith@BigCompany.com` - **Sender Name:** `RileySmith` - **Server Host:** `smtp.mailtrap.io` - **Server Port:** `25` - **Use secure connection:** `tls` - **User Account:** `c5ad636d522571` - **User Password :** `•••••••••••••••••••••`