Skip to Content

1. Purpose

This how-to guide covers the integration of IBM Lotus Notes client with SAP Cloud for customer. SAP offers only email client integration. Email client integration is possible with MS Outlook and Lotus Notes. This document will walk you through the Lotus Notes integration.

2. Prerequisites

Current email integration supported only for client based integration and Add-in provided for the following versions of Lotus Notes.

●          Lotus Notes 9

●          Lotus Notes 8.5.x              


a.     Add-in Download

        As this guide is focusing on integration between SAP Cloud for Customer and Lotus Notes client, first download the Lotus notes add-in from the tenant



          Please select Add-in for IBM Lotus Notes from the list       

By clicking above link will prompt “” file to save. Please save the file in desktop or downloads folder in the local machine.

a.     Add-in Install

        Go to Lotus client and click on Application Menu and Install.

        This is a client side activity, so each user has to download this plug-in to integrate with SAP Cloud for Customer solution.


           Select the Search for new features to install. This will prompt an option of the installation.


        Click on the Add Zip/Jar Location. This will prompt for folder structure in local machine


                    Now select the “” from download folder.


               Click OK


               Click on Finish


     Select the package to install (Expand the node to verify the plugin version) and click next


               Select the accept the licence terms and click next



                       Click on Finish button to complete the Add-in.


     You might get a below warning about plug-in authenticity. Select the Install option and click OK.


               Lotus notes client restart is required for the plug-in to take effect.


   c.     Add-in Configure

   To ensure the Lotus notes Add-in for SAP Cloud for Customer is installed, click on File and then select Preferences


      Please check for SAP Cloud for customer and click on the option from left Navigation pane       


Fill-in the SAP System URL, Username and password for the Cloud for customer Tenant.

Click on the connectivity to SAP System.


Confirm the connectivity and click OK



                            Now go to Side bars of Lotus Notes and new tab will be created for SAP Cloud for Customer


                        Enter your URL and access credential another time in this pane to start the sync


Now you have successfully logged into SAP Cloud for Customer from Lotus Client.

You can see the object that are integrated directly via Lotus client.


3. Working with SAP Cloud Customer and Lotus client

          a.     SAP cloud for customer calendar in Lotus client

                      Once the initial setup is done, this will automatically create a contact group as below.


b.     SAP cloud for customer mail navigation pane view in Lotus client

              The Sync status can be checked in the left navigation pane view in the Lotus notes client.


c.     SAP cloud for customer – Object Sync

             Once the setup is completed and successful then a synchronizing of following objects will take place automatically.

             The following features are available from Lotus client

Unidirectional Sync:

    • Access Account information
    • View associated items of Opportunities
    • View associated items of Lead

Bidirectional Sync

    • Appointments
    • Tasks or e-mails
    • Create activities and add them with reference to Account, Campaign, Opportunity or Lead

Note: When the appointment created in Lotus client, this will not be sent to all the recipients of the appointment. Calendar entry/blocked for the user who is creating it. User has to send manually to the intended recipients.

4. Conclusion

Now we have completed the integration aspect of email with SAP Cloud for customer.

Details about how to working with the SAP Cloud for customer objects exposed with in lotus notes

will be published in a separate blog.

Kindly refer to my next topic on “SAP Cloud for customer – working with Lotus notes”.

Please feel free to provide your input on this content. Thank you for your time.


About SAP Cloud:


To report this post you need to login first.


You must be Logged on to comment or reply to a post.

  1. Carola Henze

    Hi Prasad,

    thank´s for this blog. Do you know is it possible to install the Lotus notes addin also within a Citrix serverfarm?

    Kind Regards

    Carola Henze

        1. Prasad Venkatesan Post author

          Hi Carola,

          Really sorry for the delay. I just got an update from Lotus Admin team, here’s the update that I have received “The users will be able to install Add-on , from their client if its available for them.”

          Hope this helps. Thanks



    1. Prasad Venkatesan Post author

      Hi Angelo,

      Yes, it should work. The Add-in provided in the form of plugin for Lotus Notes. So you have to install this plugin (java based) as you install like any other plugins. Ideally it should work for Mac the same way as windows platform.



    2. Pushkar Ranjan

      Please note the prerequisites section where it states that only Windows is supported as of the moment. Hence, the plugin will not work on the Mac OS platform. Thank you,

      1. Angelo Fumagalli

        Hi Prasad, hi Pushkar

        We checked it out and it works on MAC. The MAC is with OSX 10.10.1 and Lotus Notes 9.0.1FP2. It should work with Notes 8.5 as well told my IT guy.

        It synchronized contacts, activities and opportunities (see screenshot).

        Best regards


        1. Prasad Venkatesan Post author

          Hi Angelo,

          Thanks for the confirmation and it really helps me. When I was looking at the plugin files, it is a bundled as a .jar (Java archive) and since Lotus client is built on java, I was expecting this to work as well. But it is good to get the confirmation from you.

          Appreciate your confirmation on the same. Thanks



  2. Bueno Felipe

    Hi Prasad.

    I’m having troubles with the Lotus Notes add in. When I want to log on in Lotus Notes a message appears showing that my authentication failed. First I thought that it was an error with the configuration of the add in, so I uninstalled and installed it again with the same configuration that this document describes, but the problem persists. I double check my credentials but there is no error here because I can log on in the web tenant without any trouble. Can you help me please? I don’t know what is wrong, 2 weeks before I was working just fine on this add in.

    This is the message that appears when I want to log on.

    problems with the addin.png

    Thank you for your help and best regards!

    1. Prasad Venkatesan Post author

      Hi Felipe,

      Thanks for reaching out to me. Based on your issue description, I can think of the following place holders you can troubleshoot.

      1. Please verify the URL. it should not contain https://sso.<tenant>.com. It should be https://my<>. I hope its correct based on the screenshot but check it out.

      2. Alternatively, click Settings on SAP Cloud for Customer Right Panel on Lotus notes and check verify the SAP system URL and user credentials. You can also check connectivity by clicking the button.

      3. As far as Lotus login concern, you don’t need any business config or special access rights. As long as you have the tenant access, you should be able to logon on this plugin as well.

      It appears that it was working but it stopped very recently. May be it is worth to check the is there any version upgrade on Lotus notes. Also check the prerequisites for Lotus version change.

      Hope this helps. Please try and let us know. Thanks



  3. Bueno Felipe

    Hi Prasad.

    Thank you for your quick response and comments. The URL of my tenant and my credentials are good, I checked in the web interface and I can Log on without any problems to my production and test tenants. Here is a screen shot of the configuration of the add in.

    add in configuration problems.png

    Apparently there are troubles with the connectivity. One issue could be that my company manage web access restrictions for internal security and they block some web pages. How can I fix this?

    Thank you very much for your help!

    1. Prasad Venkatesan Post author

      Hi Felipe,

      I have just checked my settings and I am getting the same error too.

      I guess, it is better to raise an incident with SAP. To me this appears to be a issue between Notes and C4C communication.

      @Pushkar, let me know your thoughts/comments. Thanks



    2. Prasad Venkatesan Post author

      Hi Felipe,

      Looks like SAP release new plugin version for 1411 build, hence it is required to uninstall the existing or upgrade the plug-in with the new one.

      You can download and update the same. It will work for you and I have tested it from my end. Hope this helps and thanks.



      1. Bueno Felipe

        Hi Prasad.

        I just uninstalled and download again the same way. This time the add in worked just fine.

        Thank you very much for your help!

        Greetings and my regards!

  4. Pushkar Ranjan

    Recommended best practice:

    Please remember to have the latest plugin installed be it the Outlook plugin or any of the other plugins as they generally get refreshed for each release (every 3 months) and especially if there is a functional enhancement to a specific plugin.

    Thank you.

    1. Prasad Venkatesan Post author

      I agree. Also submitted an idea to push the Add-in or notification about the new version once the client connects to the Tenant. This will avoid the time to invest in troubleshooting.




Leave a Reply