Runtime HRMS Docs
  • Introduction
  • Getting Started
    • Welcome
    • FAQs
    • Manage Subscription
      • Billing & Payments
      • Multiple Businesses
      • Users & Access
    • Addons
      • Travel Tracking
      • WhatsApp Addon
      • Custom Domain
      • Remote Punch Address
      • Project Management
      • Performance Management
      • Credits
      • Recruitment Plus
    • Setting Up
      • Business Information
      • Designations
      • Departments
      • Locations
  • Employee Management
    • Overview
    • Add New Employee
    • Import Employees
    • Employee Onboarding
    • Employee Information
    • Employee Work Profile
    • Employee Salary
    • Asset Management
    • Employee Separation
    • Exit Reasons
    • Information Verification
    • Workman Access
    • ESS Portal Access
  • Attendance & Leaves
    • Overview
    • Attendance Types
      • Remote Punch
      • Missed Punch
      • Gatekeeper Scan
      • QR Punch
      • Travel Punch
      • Excel Import
      • Manual Entry
    • Live Travel Tracking
    • Attendance Settings
    • Shift Policies
    • Shift Rules
    • Strike Rules
    • Week Off Policies
    • Monthly Attendance
    • Manual Attendance
    • Holidays
    • Weekly Offs
    • Comp Off
    • Leave Management
      • Leave Types
      • Leave Grant and Lapse
      • Leave Correction
      • Leave Encashment
      • Leave Request Approval
    • Overtime Rules
  • HR Management
    • Overview
    • HR Letters
    • HR Policies
    • Digital Notice Board
    • Automated Greetings
    • Workflows
  • Payroll & Compliances
    • Overview
    • Periods
    • Salary Components
    • Salary Deductions
    • Salary Structures
    • Claims & Reimbursements
    • Travel Reimbursement
    • Processing Payroll
    • Statutory Compliances
      • Provident Fund (PF)
      • Employees State Insurance (ESI)
      • Professional Tax
      • Income Tax
      • Income Tax Declarations
  • Reports
    • Overview
    • Salary Reports
      • Salary Summary
      • Salary Register
      • Salary Slips
      • Time Salary
      • Variable Salary
      • Cost To Company
      • Bank Transfer Letter
      • Salary Deductions
    • Employee Reports
      • Employee Register
      • Employee Joining
      • Employee Exit
      • Increment Ageing
      • Promotion Ageing
      • COVID-19 Vaccination
      • Employee Events
    • Attendance Reports
      • Leave Register
      • Attendance Register
      • Time Register
      • Travel Register
      • Time Strikes
      • Remote Punches
    • Statutory Reports
      • ESI Reports
      • PF Reports
      • Income Tax Reports
        • Income Tax Deduction
        • Income Tax Computation
        • Income Tax FORM-16
        • TDS Return (24Q)
  • Integrations
    • Overview
    • E-Mail Integration
    • Biometric Integration
    • WhatsApp Integration
    • CRM Integration
    • Payouts
      • Terms of Use
Powered by GitBook
On this page

Was this helpful?

  1. Integrations

E-Mail Integration

This articles explains how to configure your business e-mail address in Runtime HRMS to send e-mails to employees from your business email address.

PreviousOverviewNextBiometric Integration

Last updated 9 months ago

Was this helpful?

Runtime HRMS send all employee communications from the default e-mail address i.e. notifications@runtimehrms.com, unless your configure your email settings using the process described here.

To configure your e-mail settings, go to Setup > Integrations

On E-Mail Integration, click on Setup

If you have not configured mailbox earlier, you will see an empty box as shown below:

Enter a display name and the official email address and click on Create Mailbox.

Once the mailbox is created, you will see the Delete Mailbox button and available integrations as shown below:

One the mailbox is created, the system will include your email address in the reply-to field of all emails. This will ensure that if your team members reply to the system emails, the reply will come on the specified email address instead of the default unmonitored mailbox.

Configure Sending Address (Optional)

Runtime HRMS Supports email integration with popular email providers to send email from your official email address instead of the default mailbox.

There are 3 methods to begin email integration, as described below:

SMTP Integration

To begin with SMTP integration, you will need following details:

  1. SMTP Username (usually this is same as email address)

  2. SMTP Password

  3. SMTP Server

  4. SMTP Port

  5. SMTP requires SSL (Yes/No)

Sample settings:

Setting
Example

Username

acme@example.com

Password

acme@123

SMTP Address

smtp.example.com

SMTP Port

587

Use SSL

Yes

Click on SMTP button and enter all the details as shown below:

Click Save SMTP to save the settings.

Wait, we are not done yet! Click Send Test Mail to check if the given settings are correct or not. The system will try to send a test mail using the SMTP settings specified by you.

If the test mail is successful, the mailbox will become active.

Once the email integration is active, Runtime HRMS will use the provided email credentials to send all emails to team members.

If your mailbox settings change, please follow the same steps to configure the integration again. In case Runtime HRMS detects that the settings are no longer valid and emails cannot be sent, the mailbox will automatically become inactive and emails will start flowing through the default mailbox. We'll also notify you once this happens.

Gmail Authentication

To configure your official Gmail account as email provider, click on Gmail button.

Important: Please read Google API Services User Data Policy and Runtime Software Privacy Policy to understand how we store and use your mailbox authentication details.

Click on Authenticate with Google. You will be redirected to Google sign-in screen to provide your consent for sending mails.

Click on your user account to continue.

Click on Continue to grant permissions to send email on your behalf.

Once permissions are successfully obtained, you will see the above confirmation box.

Refresh the email integration page to see updated status of Gmail integration.

Wait!

We still need to test these settings to activate the integration. Simply click on Send Test Mail to check the settings. Runtime HRMS will send a test email using your google account. Once the test mailing process is successful, the mailbox will become active.

Microsoft Authentication

To configure your Microsoft email account (Hotmail, Outlook, Live etc.) as email provider, click on Microsoft button.

Click on Microsoft Authentication. You will be redirected to Microsoft sign-in screen to provide your consent to send emails using your account.

Review the requested permissions and click on Accept

Once the permissions are obtained, the status will change to Authenticated.

Wait

We still need to test these settings to activate the integration. Simply click on Send Test Mail to check the settings. Runtime HRMS will send a test email using your google account. Once the test mailing process is successful, the mailbox will become active.

Important Information regarding OAuth 2.0

OAuth 2.0 is a industry standard method to grant permissions to your Gmail & Microsoft accounts. Runtime HRMS is a registered and approved provider with both Google and Microsoft to obtain these permissions.

After your provide your permission, Runtime HRMS DOES NOT get access to your account password. We only store an access token which is used to authenticate your account with Google/Microsoft to send mails.

Setup > Integrations
Email Integration
Create Mailbox
Mailbox Created
SMTP Settings
Mailbox Active
Configure Gmail Account
Google OAuth Consent Screen
Confirmation of permissions (Send email on your behalf)
Permissions Obtained
Google OAuth status updated to Authenticated
Configure Microsoft Account
Microsoft OAuth status updated to Authenticated