CRM Web API - Prepare for Upgrades

Visit Website View Our Posts

CRM Web API - Prepare for Upgrades



A Web API was introduced for CRM 2016 Online and On-Prem and will eventually replace the existing Organization.svc, OrganizationData.svc and Discovery.svc endpoints. Developers use the API to communicate with the CRM data via their custom code, external applications and services. Why has Microsoft introduced this new API?  Microsoft's public reason was to "make it easier to create applications across a wide variety of platforms, devices, and programming languages."  This API is REST-like and is expected to eventually provide complete parity with the existing Organization.svc endpoint that we use today. They have only explicitly stated that the OrganizationData.svc has been deprecated thus far in CRM 2016, but it's a good idea to start planning your upgrades.


Common components you will need to plan for in your upgrade:




CRM Helper pages, Windows Services, Web Services that utilize the existing Organization.svc:







  • For this initial release of CRM 2016, Microsoft still has several issues to be resolved before complete parity is achieved with the existing Organization.svc endpoint. This may not affect most scenarios, but be sure to check out their list when planning your upgrades:



  • Other applications (such as Scribe) or the MSCRM plugin registration tool that utilize the Discovery.svc.  Aside from updated versions that those ISVs and MS will need to provide for you, be sure to point those to the new Discovery endpoint in 2016:



This may seem like a huge undertaking for any organization with a substantial amount of custom code, so I'd like to point out some of the positives for using this Web API as it is a pretty exciting step forward:



  • Code will be easier to manage, utilizing modern technologies that most developers are already familiar with such as JSON, HTTP requests. It does not require reference to the dlls that we often have to include in our CRM solutions. It also does not require knowledge in the .NET framework and languages associated with it (C#, VB, etc.).  You absolutely can continue to use those languages, but you can also choose to code from other supported languages such as Java, Python, etc.





  • Custom workflows should not be upgraded at this time.  Per MS, "you’ll continue to use the classes defined in the SDK assemblies to use the organization service"



Beringer Associates is a leading Microsoft Gold Certified Partner specializing in Microsoft Dynamics CRM and CRM for Distribution. We also provide expert Managed IT Services, Backup and Disaster Recovery, Cloud Based Computing and Unified Communication Systems.

by Beringer Associates

1 thought on “CRM Web API - Prepare for Upgrades”

  1. Hello,

    is there any additional information about this upgrade? Especially about API changes. Any documentation?


Comments are closed.

Show Buttons
Hide Buttons