Integrate Microsoft Dynamics 365 with OneNote


Applies To: Dynamics 365 (online), Dynamics CRM Online

Set up OneNote Integration in Microsoft Dynamics 365 (online) so that a dedicated OneNote notebook is automatically created for the selected entity records in Dynamics 365. This feature provides you the ability to easily take notes in the context of a Dynamics 365 record in various formats such as pictures, drawings, formatted text (bullet points and tables), and voice recordings in a OneNote notebook. You can access the OneNote notebook directly on the activity wall in the Dynamics 365 web client or from the record form in the Dynamics 365 mobile apps.


This feature was introduced in Microsoft Dynamics CRM Online 2015 Update 1, and is available only for Dynamics 365 (online).

Developers can enable or detect OneNote Integration for an entity in Dynamics 365 (online) using the IsOneNoteIntegrationEnabled attribute. OneNote integration can only be enabled for an entity when both the following are true:

By default, OneNote integration is enabled for the following entities: Account, Lead, Opportunity, and Product.

You must also ensure that the activity feed wall is enabled for an entity to be able to see and use the OneNote file for the entity record. For more information about configuring activity feeds wall, see Configure activity feeds.

You can use the SharePointDocumentLocationRecord.LocationType attribute to identify if the location for an entity record points to a SharePoint folder or to an OneNote notebook. This attribute can have the following values:





  • 0: General

  • 1: Dedicated for OneNote Integration

  • Points to a SharePoint folder

  • Points to a OneNote notebook

You cannot manually create an instance of SharePointDocumentLocationRecord with the value of the LocationType attribute as 2. It is automatically created for an entity record when you enable OneNote integration for it.

An entity record in Dynamics 365 can at most have one location record that points to OneNote notebook. A OneNote notebook is automatically created for a record the first time you select the OneNote tab in the activities area in Dynamics 365. The notebook is stored in the associated SharePoint document location record folder for the record. If there is more than one associated folders, the notebook is created in the first folder. Section groups are not supported in OneNote files in Dynamics 365. For more information about using the OneNote integration feature, see Help & Training: Set up and use OneNote in CRM.

See Also

Actions on SharePoint location records
SharePointDocumentLocation entity messages and methods
Integrate Microsoft Dynamics 365 with SharePoint
Use Parature knowledge in Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. Copyright