Contact Us Today!

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"

Stay tuned as I dive further into the Web API. Beringer Associates is always here to provide expert knowledge in topics like these. Please contact us with any questions you may have.



Rob is the CTO of Beringer Technology Group, and focuses his efforts on software development, cloud engineering, team mentoring and strategic technical direction. Rob has worked with Beringer since 2005, and has influenced every department from Development, Security, Implementation, Support and Sales. Rob graduated with his MBA from Rowan University in 2012, earned his Bachelors of Computer Science in 1997, and is current with several Microsoft technical certifications. Rob is very active, and loves to mountain bike, weight train, cook and hike with his dog pack.