Lead entity


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

A lead entity represents an individual that is identified as someone who is interested in receiving specific information about the products or services offered by the company. The information is provided to a lead by a salesperson through email or other communication activities available in Microsoft Dynamics 365. A lead is used to track contacts or accounts that are potential customers, but who have not yet been qualified.

Lead management is largely the same as opportunity management. However, a lead is kept separate from customer and opportunity data until the lead is qualified. The possible states for a lead are Open, Qualified, and Disqualified. A qualified lead may be converted to an account, contact or opportunity. To convert, use the QualifyLeadRequest message.

The following items can be associated with a lead:

  • Contact and account information

  • Customer requests

  • Activities

  • Notes

  • Attachments

A link is maintained between the lead and any accounts and contacts. You can create this link by using the IOrganizationService.Execute method with the AssociateRequest or the DisassociateRequest messages. This makes it possible to generate reports that indicate the value of different lead sources.

When you enter a lead into Microsoft Dynamics 365, you can use the process (workflow) engine to automatically route it to a specific user or team based on rules that are defined by the business unit or channel partner. Upon qualification, the lead is either converted to an opportunity or is inactivated, but retained to allow for accurate business reporting, for example, analysis of the effectiveness of different lead sources. For more information, seeAutomate business processes using Dynamics 365 process.

See Also

Lead entity messages and methods
Sample: Qualify a lead
Sales entities (lead, opportunity, competitor, quote, order, invoice)
Opportunity entities

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright