Lead entity


Applies To: Dynamics CRM 2013

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 CRM. 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 CRM, 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, seeWrite workflows to automate business processes.

See Also

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