--- title: "Google Gmail" slug: "google-gmail" updated: 2024-09-23T02:38:33Z published: 2024-09-23T02:38:33Z canonical: "docs.processmaker.com/google-gmail" --- > ## 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. # Google Gmail ## Google Gmail Driver Settings Google Gmail is one of the most widely use email services in the world. Configure an email server to authenticate with Gmail Simple Mail Transfer Protocol (SMTP) from which to send emails. ## Configure Gmail 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. Refer to the following sections in this order to configure an email server for Gmail SMTP authentication: 1. [Enable Gmail SMTP OAuth in email server settings](/v1/docs/email-default-settings#enable-gmail-smtp-oauth-in-email-server-settings). 2. [Create Google credentials for the email server's OAuth client](/v1/docs/email-default-settings#create-google-credentials-for-the-email-servers-oauth-client). 3. [Authorize the Google account on the email server](/v1/docs/email-default-settings#authorize-the-google-account-on-the-email-server). ### Enable Gmail SMTP OAuth in Email Server Settings Follow these steps to enable SMTP authentication for the Gmail email server settings: 1. [Create a new email server configuration](/v1/docs/email-default-settings#create-a-new-email-server-configuration). Email server settings display. The settings for the SMTP mailer driver display. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/26fd9e4a-88fd-4663-af2e-ae8231e63250.png) 2. Click the **SMTP Authentication Method** setting. The **SMTP Authentication Method** screen displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/99cb9a93-684d-448b-9d39-99665d9560cd.png) 3. Select the **google** option, and then click **Save**. The settings for the Gmail email server display. Until providing the Gmail client ID and Gmail client secret, the label **Not Authorized** displays in the **SMTP Authentication Method** setting. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/e66e7b41-bf6b-43f3-ba9d-8d85a3335487.png) 4. 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) 5. Select the **tls** option if it is not currently selected. Click **Save** if you changed this setting. 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 Port** setting. The **Server Port** screen displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/89c0bad7-2950-4275-b477-d78f4368c94a.png) 7. Enter `587`, 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 Host** setting. The **Server Host** screen displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/27921f05-b2f0-400e-9185-6d1702a1960b.png) 9. Enter `smtp.gmail.com`, and then click **Save**. 10. From the **Gmail Redirect URI** setting, copy the redirect URI for creating the Gmail SMTP OAuth integration. This redirect URI is automatically configured for this email server after selecting the **SMTP Authentication Method** setting. Google calls back to this URL after Google authenticates a valid Google app in ProcessMaker Platform. 11. [Create Google credentials for the email server's OAuth client](/v1/docs/email-default-settings#create-google-credentials-for-the-email-servers-oauth-client). ### Create Google Credentials for the Email Server's OAuth Client Follow these steps to create Google credentials for the Gmail email server's OAuth client: 1. [Ensure that SMTP authentication is enabled for the Gmail email server](/v1/docs/email-default-settings#enable-gmail-smtp-oauth-in-email-server-settings). 2. Log on to [Google Cloud Console](https://console.cloud.google.com/). 3. From the Google Cloud menu, click **APIs & Services**, and then **Credentials**. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/5a6a9877-98c7-4896-9a8a-c3b6cbe53323.png) The **Credentials** page displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/bf9a63cf-9c39-48e8-ab59-5fc81e505303.png) 4. Click **+Create Credentials**, and then select the **OAuth client ID** option. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/2617f341-ce4e-4a7e-9da1-cd5c4930dad7.png) The **Create OAuth client ID** page displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/23229e1c-bb46-4a40-a02d-c8943a81109e.png) 5. Click the **Application type** drop-down menu, and then select the **Web application** option. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/3f261137-2544-4b4c-8266-84fbfb1eed9b.png) 6. In the **Name** setting, enter a name for the credential. This name displays only in the Google Cloud console. 7. From the **Authorized redirect URIs** section, click the **+Add URI** button to allow requests from a Web browser. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/ba3cb7c0-e4a9-4c0c-856f-a0f9644b67b5.png) The **URIs 1 setting** displays to enter a valid URI from a Web server. 8. In the **URIs 1** setting, enter the Gmail Redirect URI copied from your ProcessMaker Platform instance. 9. Click **Create** at the bottom of the page. Note that it may take between five (5) minutes to a few hours for Google Cloud to enable this OAuth client. The **OAuth client created** screen displays with the client ID and client secret for this Gmail SMTP OAuth integration with your ProcessMaker Platform instance. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/6276ff5e-de5b-49a4-bbfe-4bc2d2a9dff3.png) 10. From the **Your Client ID** setting, copy the client ID, and then save it for later configuration in the Gmail email server. 11. From the **Your Client Secret** setting, copy the client secret, and then save it for later configuration in the Gmail email server. 12. Click **OK** to close the **OAuth client created** screen. 13. [Authorize the Google account on the email server](/v1/docs/email-default-settings#authorize-the-google-account-on-the-email-server). ### Authorize the Google Account on the Email Server Follow these steps to authorize the Google account for the Gmail SMTP OAuth integration: 1. Ensure the following: - [An email server in ProcessMaker settings is configured for a Google Gmail SMTP OAuth integration](/v1/docs/email-default-settings#enable-gmail-smtp-oauth-in-email-server-settings). - [Google credentials for the Gmail email server's OAuth client has been created and the client ID and client secret for that integration can be referenced](/v1/docs/email-default-settings#create-google-credentials-for-the-email-servers-oauth-client). 2. In the ProcessMaker settings, access the email server configured for the Gmail SMTP OAuth integration. 3. Click the **Edit** ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/b3630a8e-2828-4a12-a117-278a547a47b7.png) icon for the **Gmail Client ID** setting. The **Gmail Client ID** screen displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/3b1d72ba-739d-4b06-ae19-505ca790a30b.png) Enter the client ID copied from the Google Cloud OAuth client. 4. Click the **Edit** ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/b3630a8e-2828-4a12-a117-278a547a47b7.png) icon for the **Gmail Client Secret** setting. The **Gmail Client Secret** screen displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/7c32ef37-accd-4170-9572-a72ae429c44d.png) Enter the client secret copied from the Google Cloud OAuth client. 5. Click the **Authorize Account** button at the top of the email server settings. The **Sign in with Google** screen displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/a7d0d09f-1864-4cc9-8d1b-fabc5bf50f65.png) 6. Select the Google account with which to allow the Google OAuth client to access your Gmail email server. 7. Click the **Allow** button to grant authorization. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/14aa3f3d-b9b5-4bf4-80ac-141aa39f9ec0.png) If the Google SMTP OAuth integration is configured correctly on your email server settings, then the email server settings display again, and the **SMTP Authentication Method** setting indicates that Google authorized this email server to use the Google Cloud Web application. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/6eaec052-ffb0-4deb-a8b7-f7baaaf8e4ca.png) 8. [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).