I’ve received a lot of questions lately about integrating Maximo with Office 365 for email notification purposes. Let’s take a moment to review the steps necessary to configure this for your organization.


  1. You will need to provide Maximo with a set of credentials that it will use as the “from” email address. All email coming from Maximo will need to utilize this address (more on that below). For the purposes of this tutorial, we are going to assume this configuration.
  2. Alternatively, you can configure a proxy in Office 365 to effectively create a mail relay situation. For example, you might configure a “donotreply@organization.com” address that can be used as the “from” email address that does not need to supply authenticated credentials.

IBM WebSphere Configuration

Office 365 works over SSL. In order for WebSphere to make a proper SSL connection to Office 365, we need to import the Office 365 SSL certificate into WebSphere’s trust store. This will make the connection trusted from WebSphere’s perspective and allow the connection to happen. WebSphere will throw an error if it attempts to make a connection to an untrusted source.

  1. Log into the WebSphere Console as an administrative user.
  2. Navigate to the Security > SSL certificate and key management screen.
  3. Click on the Key stores and certificates link.
  4. Click on the CellDefaultTrustStore link.
  5. Click on the Signer certificates link.
  6. Click on the Retrieve from port button.
  7. Fill out the following required fields:
    1. Host: outlook.office365.com
    2. Port: 993
    3. Alias: outlook.office365.com
  8. Click the Retrieve signer information button.
  9. Click the OK button.
  10. Click the Save to master configuration link.
  11. Once the node synchronization happens, log out of the WebSphere Console.
  12. For this change to take effect, the IBM-related Windows Services will need to be restarted (all Node Agents, the Cell Manager, and the HTTP Server).

Maximo System Properties

The next step is to configure System Properties within Maximo.

  1. Log into Maximo as an administrative user.
  2. Navigate to the System Configuration > Platform Configuration > System Properties application.
  3. Set the mail.smtp.host property to smtp.office365.com
  4. Set the mail.smtp.starttls.enable property to true
  5. Set the mail.smtp.ssl.enable property to false if it is not already false (default is false)
  6. Set the mxe.smtp.user property to the email address you wish all Maximo email notifications to come from (e.g. alex@a3jgroup.com).
  7. Set the mxe.smtp.password property to the Office 365 password for the above user. Please note that it’s also a good idea to check the Masked? checkbox for this property in order to keep the password value hidden in the Maximo user interface.
  8. Click the New Row button to create a new System Property. Fill out the following fields:
    1. Property Name: mail.smtp.port
    2. Description: Port number that the SMTP mail server listens on
    3. Global Value: 587
  9. Click the Save button.
  10. Check the box next to each of the properties above that you had to edit. Then in the Common Actions menu, click the Live Refresh button.
  11. Click the OK button.

Maximo Communication Templates

Each of the Communication Templates in the system must now have the Send From email address set to the same email address that was used to populate the mxe.smtp.user System Property.


Maximo Scheduled Reports

You may want to schedule reports to run from Maximo to be emailed to users or groups. Like all other email, the Send From address has to be the value that you configured in the mxe.smtp.user System Property. Unfortunately when Maximo schedules a report to be emailed, it uses the email address from the user that created the report schedule as the Send From address. This will cause most scheduled reports to fail.

The least intrusive solution that I’ve come up with is to create a user that has the same email address that was used to populate the mxe.smtp.user System Property, and then create an automation script to change the user at runtime of the scheduled report. This will allow the system to send scheduled reports via email.

  1. Ensure that you have a user account that has the same email address that was used to populate the mxe.smtp.user System Property.
  2. Navigate to the System Configuration > Platform Configuration > Automation Scripts application.
  3. From the More Actions menu, choose the Create > Script with Object Launch Point option.
  4. In the ensuing dialog, Create Script with Object Launch Point: Step 1 of 3, fill out the following fields:
    1. Launch Point: REPORTRUNQUEUE_LP
    2. Description: Report Run Queue Launch Point
    4. Active: Yes
    5. Events: Save
    6. Save: Add and Before Save (see screenshot)
    7. Script: New
  5. Click the Next button.
  6. In the next step, Create Script with Object Launch Point: Step 2 of 3, fill out the following fields:
    2. Description: Report Run Queue Script
    3. Script Language: python
  7. Click the Next button.
  8. In the next step, Create Script with Object Launch Point: Step 3 of 3, fill out the following fields:
    1. Source Code:

from psdi.mbo import MboConstants
mbo.setValue("USERID", "AWALTER", MboConstants.NOACCESSCHECK)

Be sure to substitute the User ID of your user for the AWALTER text in the example above. Click the Create button and you’re set!

That should enable you to utilize Office 365 as your email solution from Maximo. Please feel free to leave comments below.

Alex Walter is the Chief Innovation Officer at the A3J Group, a company he formed to address the need for innovative software solutions and integrated consulting services within the EAM industry. Alex brings 17 plus years of experience in business consulting in various industries including Life Sciences, Oil and Gas, Water and Waste Management, Education, Government Facilities, among others. Alex lives in Tampa, FL with his wife, two sons, and dogs. In his free time, he enjoys running half marathons, making space in his garage for new camping and outdoor equipment, traveling to far off places with the Walter Circus, and remaining hopeful that his NY Jets' best days are ahead of them and not behind.

4 Thoughts on “Maximo email with Office 365”

  • You are the man!!!! Thanks a million.. I was trying to do an SMTP Mail server on my host and relay through office365 with little to no success. This is perfect and much easier.

  • Curious — are you able to take advantage of the email groups and group lists setup in Office 365 from within Maximo to prevent duplicative list updating and administration?

  • Keep in mind that the office 365 server could use at least 2 different certificates (one using GlobalSign and the other one using Digicert) and WAS needs both of them, otherwise some emails won’t be sent.
    This could be done by repeating the same actions in the Admin console until the server responds with the 2 certificates.

Leave a Reply

Your email address will not be published.