Download the endpoints using the Microsoft Dynamics 365 Developer resources page

 

Updated: June 13, 2017

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

The Developer Resources page in the Microsoft Dynamics 365 (online & on-premises)web application provides important resources. Included on this page are the web service endpoint URLs, a certificate for accessing Microsoft Azure, and other organization information that you'll need during development. To access the page in the web application, click Settings> Customizations, and then click Developer Resources.

For the “Organization service” and “Organization data service” sections in this topic, the example URLsinclude an OrganizationName. This refers to the organization that you specify in the URLwhen you access the web application. For example, for Contoso.crm.dynamics.com, the OrganizationNameis Contoso. ServerNamerefers to the name of the server, including the port number, for example, myserveror myserver:5555.

Shows the unique name for your organization, which is needed when interacting with the discovery service. Note that this may not be the same as the name that’s specified in the URL. This name can be found in the following properties:

  • Deployment web service: UniqueName

  • Discovery web service: UniqueName

  • Organization web service using early bound classes: Organization.UniqueName

You can also retrieve this from the discovery service by using the RetrieveOrganizationsRequestmessage.

Provides a download link to the public certificate that is required to configure Microsoft Azurefor Microsoft Dynamics 365integration. For an on-premises or Internet-facing deployment, this information is only visible after Dynamics 365has been configured for Azureintegration.

For more information, see Azure extensions for Microsoft Dynamics 365and Walkthrough: Configure Dynamics 365 for integration with Microsoft Azure.

The Microsoft Dynamics CRM Developer Centeror crmdevelopercenter.comcontains a wealth of information to help developers. Here you’ll find the Microsoft Dynamics 365 SDK, which includes documentation, samples, and tools, as well as technical articles, ramp up kits, videos, blogs, forums, and more.

The IDiscoveryServiceweb service provides information about the organizations available on the Microsoft Dynamics 365server using the SOAPprotocol. This information includes the web address ( URL) for each organization. For more information, see Discover the URL for your organization using the Organization Service.

Use the following URLsto access the discovery service (use the appropriate URLfor your location).

Location

Discovery Web service URL

Identity Provider

North America

https://dev.crm.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft account

https://disco.crm.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

North America 2

https://disco.crm9.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

Europe, Middle East and Africa (EMEA)

https://dev.crm4.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft account

https://disco.crm4.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

Asia Pacific Area (APAC)

https://dev.crm5.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft account

https://disco.crm5.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

Oceania

https://disco.crm6.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

Japan (JPN)

https://disco.crm7.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

South America

https://disco.crm2.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

India (IND)

https://disco.crm8.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

Canada

https://disco.crm3.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

United Kingdom (UK)

https://disco.crm11.dynamics.com/XRMServices/2011/Discovery.svc

Microsoft Office 365

Use the following URLto access the discovery service:

http://ServerName/XRMServices/2011/Discovery.svc

The IOrganizationServiceweb service provides access to the business data and metadata of your organization by using the SOAPprotocol. More information: Use the Organization Service to read and write data or metadata.

Use the following URLsto access the organization service ( SOAPendpoint):

https://OrganizationName.api.crm.dynamics.com/XrmServices/2011/Organization.svc(North America)

https://OrganizationName.api.crm2.dynamics.com/XrmServices/2011/Organization.svc(South America)

https://OrganizationName.api.crm3.dynamics.com/XrmServices/2011/Organization.svc(Canada)

https://OrganizationName.api.crm4.dynamics.com/XrmServices/2011/Organization.svc(EMEA)

https://OrganizationName.api.crm5.dynamics.com/XrmServices/2011/Organization.svc(APAC)

https://OrganizationName.api.crm6.dynamics.com/XrmServices/2011/Organization.svc(Oceania)

https://OrganizationName.api.crm7.dynamics.com/XrmServices/2011/Organization.svc(Japan)

https://OrganizationName.api.crm8.dynamics.com/XrmServices/2011/Organization.svc(India)

https://OrganizationName.api.crm9.dynamics.com/XrmServices/2011/Organization.svc(North America 2)

https://OrganizationName.api.crm11.dynamics.com/XrmServices/2011/Organization.svc(United Kingdom)

Use the followingURLto access the organization service (SOAP endpoint):

http[s]://ServerName/OrganizationName/XRMServices/2011/Organization.svc

This Open Data ( OData v2) Web service provides access to the business data of your organization by exposing a RESTAPI. This link opens the Conceptual Schema Definition Language ( CSDL) document that describes how to access your data by using this API.

System_CAPS_warningWarning

The Organization Data service has been deprecated and replaced by the Web API. For more information about the Web API see Use the Microsoft Dynamics 365 Web API.

Use the following URLs to access the organization data service ( ODataRESTendpoint):

https://OrganizationName.api.crm.dynamics.com/XrmServices/2011/OrganizationData.svc(North America)

https://OrganizationName.api.crm2.dynamics.com/XrmServices/2011/OrganizationData.svc(South America)

https://OrganizationName.api.crm3.dynamics.com/XrmServices/2011/OrganizationData.svc(Canada)

https://OrganizationName.api.crm4.dynamics.com/XrmServices/2011/OrganizationData.svc(EMEA)

https://OrganizationName.api.crm5.dynamics.com/XrmServices/2011/OrganizationData.svc(APAC)

https://OrganizationName.api.crm6.dynamics.com/XrmServices/2011/OrganizationData.svc(Oceania)

https://OrganizationName.api.crm7.dynamics.com/XrmServices/2011/OrganizationData.svc(Japan)

https://OrganizationName.api.crm8.dynamics.com/XrmServices/2011/OrganizationData.svc(India)

https://OrganizationName.api.crm9.dynamics.com/XrmServices/2011/OrganizationData.svc(North America 2)

https://OrganizationName.api.crm11.dynamics.com/XrmServices/2011/OrganizationData.svc(United Kingdom)

Use the following URL to access the organization data service ( ODataRESTendpoint):

http[s]://ServerName/OrganizationName/XRMServices/2011/OrganizationData.svc

To add a service reference for these services to a Microsoft Visual Studioproject, you must append ?WSDLto the service URLwhen specifying the address in the Add Service Referencedialog box. For example, the discovery service Web Services Description Language (WSDL)address is http[s]://servername/xrmservices/2011/discovery.svc?wsdl.

The web services support SDK versioning. Specifying an SDK version in the WSDLURLindicates a scope for the amount of data to be returned in the WSDL. The syntax for web service SDK versioning ends the URL in ?singleWSDL&sdkversion=X.X. For example, the URL would be https://mydomain.crm.dynamics.com/xrmservices/2011/discovery.svc?singleWSDL&sdkversion=8.0. In this example, you would have built your application using the Microsoft Dynamics 365 SDKv8.0 assemblies.

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. Copyright

Community Additions

ADD
Show: