Programmatically authenticate multi-factor enabled Dynamics 365 CRM environment


I observed that, recently our clients are focusing more towards security aspect and hence the typical first thing they do is enabling multi-factor authentication. Now from developer’s perspective, there is no issue in accessing CRM through User Interface, because developers can get OTP on their mobile phones.

But, many times we use different third-party applications like XRMToolBox to connect to Dynamics CRM or use plugin registration tool to connect to organization. In such scenarios, we get an error even after putting correct credentials.

This blog explains solution to above problem.

Problem Statement

If multi-factor authentication is enabled for Dynamics 365, then developers could not connect to CRM via programming or Plugin Registration Tool or XrmToolbox etc., using their own password.


There is very simple solution which requires only below 2 steps:

  1. Follow this article to generate App Password.

  1. Once app password is generated and noted down from above step, use that password instead of your default password.

Hope you find this information useful!!!


You cannot delete this component while the following components depend on it.


In Dynamics 365, to delete any component, you must remove/delete all the dependencies of the component which you want to delete. For e.g. If you want to delete custom entity called Configuration, you will need to delete/remove all the dependencies of the component which are dependent on Configuration entity.

Now many times users face problems in finding where can I get the list of dependent components? It’s easy to just say Open Default Solution > Go to Entities > Select the Entity > Click on Show Dependencies. Yes. That’s absolutely correct.

Now the problem is when we don’t understand the list which is shown by CRM. This blog explains tricky component which we don’t find directly.

Problem Statement

  1. Open Default Solution (Or unmanaged solution that contains the entity you want to delete).
  2. Go to Entities tab and select the entity you want to delete.
  3. Click on Show Dependencies button. You will see a popup window something like below:

dependencies list

We cannot easily identify highlighted components from above image because of below reasons:

  1. We cannot find any name to the plugin step neither to SDK Processing Image.
  2. If we try to find the steps in Default Solution, you won’t be able to see it anywhere under Sdk Message Processing Step.
  3. If we connect using plugin registration tool, we won’t find the steps their as well.


When I investigated more on this issue, I found that there was a Business Rule which was registered on the entity and had scope as Entity. This was causing the issue.

I deactivated the business rule and deleted the same and the highlighted components got removed from the dependencies list.


Embed Microsoft Forms in your website and get leads in Dynamics 365 CRM without writing code



We come across frequent requirement where customers ask to create a custom page and embed it in their website and write logic to get leads into Dynamics 365 CRM.

In this blog, I have explained how without coding we can achieve this requirement.


Traditional Approach

We will create custom HTML page and create custom service hosted somewhere and then using JavaScript we will make a call to the web service and create respective records in CRM.

Alternative Better Approach

We can use Microsoft Forms & Microsoft Flow and without coding we can get the lead data inserted into Dynamics 365 CRM.

How-to Steps


  1. You should have D365 CRM (Sales) license.
  2. You should have access to Microsoft Forms (refer References section for the same).
  3. You should have access to Microsoft Flow.

Create Microsoft Form to get Lead Information

  1. Login to and open Forms from Admin Center.


  1. Click on New Form


  1. Name the form and keep adding questions.


  1. This is my form


  1. Click on Share option and select Embed option.


  1. Copy the Iframe tag and include it in your web page.
  2. That’s it. Your form is ready.

Create Microsoft Flow to insert response in Dynamics 365 CRM.

  1. Go to Flow from admin center.


  1. Select CREATE FROM BLANK option. Give some name to Flow.
  2. Search for Microsoft Form in connector and select Microsoft Forms – When a new response is submitted


  1. Select your form.


  1. Click Next step and select Add an Action.
  2. Search for Microsoft Forms and select Microsoft Forms – Get Response Details
  3. In the configuration put below formula as per below screenshot.



Refer this blog to understand above formula.

  1. Click on Next step and select Add an Action.
  2. Search for Dynamics 365 and select Dynamics 365 – Create a new record (V2)
  3. Select Organization.


  1. Select entity as Leads. It will show the fields of Lead entity as below.


  1. Click on Last Name textbox and select Last Name option from the right pane as per below screenshot. Repeat same steps for other fields.


Note: Click Show advanced options to see optional fields.

  1. That’s it. Finally click on Create Flow.

At this stage you are ready. You can start entering data in your form and it will automatically get inserted into Dynamics 365 CRM near to real time.


  1. Know more about Microsoft Forms

  1. Frequently asked questions about Microsoft Forms


Can I still get CRM Online trial of older version?


As Microsoft keeps releasing new versions of Dynamics 365/CRM, we should be prepared for the new features; but it is frequent requirement that, when we are about to test our customizations on older versions, and we register a trial, we get surprise of the newly released version. So, how can we test our customizations on the version we were expected?

This blog explains how can we achieve this.

Follow below steps to get older version of Dynamics CRM Online versions

  1. Visit and get started and sign up for new trial.
  2. Once you create new online environment, it will be the latest version of Dynamics 365 CRM.
  3. Go to > Admin Center.

admin center

  1. In Admin Center, click on Dynamics 365.

dynamics 365 in admin center

  1. You will see something like below:

instance manager

  1. Click on Edit. Change the Instance Type to Sandbox. Click Next & Save. After this step, you will see something like below.

sandbox options in instance management

  1. Click on RESET. You will get option to select Target Version.

target versions

  1. Select the version you want and click Reset. That’s it.

Invalid stage transition. Transition to stage {0} is not in the process active path.


With latest release of Dynamics 365, Microsoft has restricted skipping BPF stages and throws above error. When we try to change BPF stage programmatically and if we skip any BPF stage, then user will get above error.

Understand the error with the help of an example

Let’s say we have below Business Process Flow on Opportunity.

sample BPF

With D365, only below transitions are allowed.

  1. Qualify to Develop
  2. Develop to Propose
  3. Propose to Close

Below transitions are not allowed.

  1. Qualify to Propose
  2. Develop to Close
  3. Qualify to Close

How my earlier code (prior to D365 release) worked and suddenly stopped working?

Before D365 release by Microsoft, the above scenarios were considered as unsupported and there were no restrictions forced by Microsoft. Hence our code used to work in these unsupported scenarios as well. With D365 release, Microsoft has restricted these unsupported scenarios and users will start receiving the error with same code.

How have I come to this conclusion?

  1. I got the error log file with error code and same error code (-2146885629) is now available in SDK (you can search in CHM file).

SDK Error Code

  1. I raised a support ticket with Microsoft and as per confirmation from MS Support, it has turned out to be by-design. I received below response from MS Support Team.

Reply from MS Support

Note: Even though Microsoft has mentioned Environment as CRM Online, as this is by-design in D365, it applies to CRM On-premise deployments as well.


  1. After thinking about these unsupported scenarios, it makes sense to use logical branching to skip the stages if needed and if not, then we should follow the path mentioned in BPF.
  2. The resolution to this issue can be programmatically iterate the record through all the stages or use conditional branching in BPF.

How to use Business Rules to determine Form Type in Dynamics CRM


One of the frequent requirement we receive is doing basic form customizations based on Form Type. E.g. Show few fields while creating record and hide those fields once record is saved.

First option which comes in developer’s mind

As we cannot check entity’s form type using Business Rules, we must use JavaScript to achieve this requirement. Hence, usually developer will write a JavaScript method and register an event on Form Load.

This will be time consuming task as compared to the solution which I have explained below. Also, it will need technical person to achieve this requirement, because it involves coding.

An option that usually skips from developer’s mind

As we know, Created On field is populated only when record is created. Also, CRM does not allow to set Created On field to the user, we can take help of this field to determine whether user is on Create form or has opened existing record.

Below screenshot shows how Business Rule can be configured to unlock the Account on Create form and lock it for existing record.

business rule

Simple solution, but we usually miss it.

How alternate key is useful while importing data into CRM?


In this blog, I have explained how an alternate key column can be used to import the data into CRM using OOB import/export facility.

We get frequent requirements to perform initial data load for customers and contacts. In almost all cases, we are asked to link the Contacts to the customers.

This can be achieved easily using Alternate Key in CRM.

In this blog, I have assumed that we have Account Number field as an alternate key on Account entity and Contact Number (custom field) as an alternate key on Contact entity.

How to achieve this?

Case 1 (initial load): We have 2 separate Excel/CSV files as per below screenshots.





  1. We will first import the data of Account (as it is straightforward I have not explained about it in this blog).
  2. Then we import the contacts. This is also straightforward except one below check in field mapping.
    1. In field mapping we have to select the Account Number as a matching field for Company Lookup field.


Case 2 (Update existing data): Now we have contacts with accounts selected, on Accounts we need to select primary contact.

Let’s say we have below CRM view and we click on Export to Excel and put the contact numbers appropriately in Primary Contact column in Excel.


If you note in below screenshot, I have renamed Primary Contact field to Contact Number which contains Contact Numbers.



  1. Now we save the exported Excel with contact numbers and start data import with the same file. It will again give similar field mapping dialog where we have to select Contact Number as a matching field for Primary Contact field.


  1. After completing import wizard steps, you will see the result as below: