Developer resources page
The Developer Resources page in the Dynamics 365 for Customer Engagement web application provides important resources. Included on this page are the web service endpoint URLs, a certificate for accessing 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 URLs include an OrganizationName. This refers to the organization that you specify in the URL when you access the web application. For example, for Contoso.crm.dynamics.com, the OrganizationName is Contoso. ServerName refers to the name of the server, including the port number, for example, myserver or myserver:5555.
Organization unique name
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.UniqueNameYou can also retrieve this from the discovery service by using the RetrieveOrganizationsRequest message.
Microsoft Azure Service Bus issuer certificate
Provides a download link to the public certificate that is required to configure Azure for Dynamics 365 Customer Engagement (on-premises) integration. For an on-premises or Internet-facing deployment, this information is only visible after Customer Engagement has been configured for Azure integration.
For more information, see Azure Extensions for Dynamics 365 Customer Engagement (on-premises).
Discovery service
The Discovery Service web service provides information about the organizations available on the Dynamics 365 Server. This information includes the web address (URL) for each organization.
For Dynamics 365 for Customer Engagement
You should generally use the global discovery service because this will ignore regional groupings and allow you to retrieve available organizations world-wide. See Discover the URL for your organization using the Web API
If you want to scope the organizations to retrieve to individual regions use the following URLs to access the discovery service (use the appropriate URL for your location).
| Location | Discovery Web service URL |
|---|---|
| North America | https://disco.crm.dynamics.com/XRMServices/2011/Discovery.svc |
| North America 2 (GCC) | https://disco.crm9.dynamics.com/XRMServices/2011/Discovery.svc |
| Europe, Middle East and Africa (EMEA) | https://disco.crm4.dynamics.com/XRMServices/2011/Discovery.svc |
| Asia Pacific Area (APAC) | https://disco.crm5.dynamics.com/XRMServices/2011/Discovery.svc |
| Oceania | https://disco.crm6.dynamics.com/XRMServices/2011/Discovery.svc |
| Japan (JPN) | https://disco.crm7.dynamics.com/XRMServices/2011/Discovery.svc |
| South America | https://disco.crm2.dynamics.com/XRMServices/2011/Discovery.svc |
| India (IND) | https://disco.crm8.dynamics.com/XRMServices/2011/Discovery.svc |
| Canada | https://disco.crm3.dynamics.com/XRMServices/2011/Discovery.svc |
| United Kingdom (UK) | https://disco.crm11.dynamics.com/XRMServices/2011/Discovery.svc |
| France | https://disco.crm12.dynamics.com/XRMServices/2011/Discovery.svc |
| US Gov High (GCC High) | https://disco.crm.microsoftdynamics.us/XRMServices/2011/Discovery.svc |
For on-premises Dynamics 365 Customer Engagement (on-premises)
Use the following URL to access the discovery service:
https://ServerName/XRMServices/2011/Discovery.svc
For more information, see Discover the URL for your organization using the Organization Service.
Organization service
The Organization service provides access to the business data and metadata of your organization. More information: Use the Organization Service to read and write data or metadata.
For Dynamics 365 for Customer Engagement
Use the following URLs to access the Organization service:
| Region | URL |
|---|---|
| North America | https://OrganizationName.api.crm.dynamics.com/XrmServices/2011/Organization.svc |
| North America 2 | https://OrganizationName.api.crm9.dynamics.com/XrmServices/2011/Organization.svc |
| South America | https://OrganizationName.api.crm2.dynamics.com/XrmServices/2011/Organization.svc |
| Canada | https://OrganizationName.api.crm3.dynamics.com/XrmServices/2011/Organization.svc |
| EMEA | https://OrganizationName.api.crm4.dynamics.com/XrmServices/2011/Organization.svc |
| APAC | https://OrganizationName.api.crm5.dynamics.com/XrmServices/2011/Organization.svc |
| Oceania | https://OrganizationName.api.crm6.dynamics.com/XrmServices/2011/Organization.svc |
| Japan | https://OrganizationName.api.crm7.dynamics.com/XrmServices/2011/Organization.svc |
| India | https://OrganizationName.api.crm8.dynamics.com/XrmServices/2011/Organization.svc |
| France | https://OrganizationName.api.crm12.dynamics.com/XrmServices/2011/Organization.svc |
For on-premises Dynamics 365 Customer Engagement (on-premises)
Use the following URL to access the Organization service:
http[s]://ServerName/OrganizationName/XRMServices/2011/Organization.svc
Organization data service
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.
Warning
The Organization Data service has been deprecated and replaced by the Web API. For more information about the Web API see Use the Dynamics 365 Customer Engagement Web API.
For Dynamics 365 for Customer Engagement
Use the following URLs to access the organization data service (ODataREST endpoint):
| Region | URL |
|---|---|
| North America | https://OrganizationName.api.crm.dynamics.com/XrmServices/2011/OrganizationData.svc |
| North America 2 | https://OrganizationName.api.crm9.dynamics.com/XrmServices/2011/OrganizationData.svc |
| South America | https://OrganizationName.api.crm2.dynamics.com/XrmServices/2011/OrganizationData.svc |
| Canada | https://OrganizationName.api.crm3.dynamics.com/XrmServices/2011/OrganizationData.svc |
| EMEA | https://OrganizationName.api.crm4.dynamics.com/XrmServices/2011/OrganizationData.svc |
| APAC | https://OrganizationName.api.crm5.dynamics.com/XrmServices/2011/OrganizationData.svc |
| Oceania | https://OrganizationName.api.crm6.dynamics.com/XrmServices/2011/OrganizationData.svc |
| Japan | https://OrganizationName.api.crm7.dynamics.com/XrmServices/2011/OrganizationData.svc |
| India | https://OrganizationName.api.crm8.dynamics.com/XrmServices/2011/OrganizationData.svc |
| France | https://OrganizationName.api.crm12.dynamics.com/XrmServices/2011/OrganizationData.svc |
For on-premises Dynamics 365 Customer Engagement (on-premises)
Use the following URL to access the organization data service (ODataREST endpoint):
http[s]://ServerName/OrganizationName/XRMServices/2011/OrganizationData.svc
Using the WSDL
To add a service reference for these services to a Visual Studio project, you must append ?WSDL to the service URL when specifying the address in the Add Service Reference dialog 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 WSDL URL indicates 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 v8.0 .NET assemblies.
See also
Write Code for Dynamics 365 Customer Engagement Web Services
Use the IOrganizationService web service to read and write data or metadata
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for