welcome to XRM blog

Keep in touch with latest CRM/ERP articles

To remain competitive your organisation must be efficient across the business process spectrum. To do so you need to take sound decisions based on a balance between the cost and risk. To do so you will be heavily dependent on your content management in itself needs...

image
Blog

Send Email using a Plugin in Dynamics 365

By Ishaan Sheikh on 12/28/2020

In this blog, I will show you how to send email using a plugin in Dynamics 365 using C#.

For this example, let us suppose we need to send an email to the new contact that has been created. 

First, create a new class library project in Visual Studio, as shown in the image below.

Now create a class named SendEmail.cs and add the following references to your project using NuGet and then add it to the top of the class.

using Microsoft.Crm.Sdk.Messages;

using Microsoft.Xrm.Sdk;

using Microsoft.Xrm.Sdk.Query;

Now add the following code in the file.

namespace SendEmailPlugin

{

    public class SendEmail : IPlugin

    {

        public void Execute(IServiceProvider serviceProvider)

        {

            // Step - 1

            ITracingService tracingService = (ITracingService)serviceProvider.GetService(typeof(ITracingService));

            IPluginExecutionContext context = (IPluginExecutionContext)serviceProvider.GetService(typeof(IPluginExecutionContext));

            IOrganizationServiceFactory serviceFactory = (IOrganizationServiceFactory)serviceProvider.GetService(typeof(IOrganizationServiceFactory));

            IOrganizationService Service = serviceFactory.CreateOrganizationService(context.UserId);

 

            try

            {

                if(context.InputParameters.Contains("Target") && context.InputParameters is Entity)

                {

                    // Obtain the target entity from the input parmameters.

                    Entity entity = (Entity)context.InputParameters;

 

                    if (entity.Attributes.Contains("emailaddress1") && entity.Attributes.ToString() != "")

                    {

                        // Step - 2

                        // Creating the 'From' activity party for the email

                        Entity fromParty = new Entity("activityparty");

                        fromParty = new EntityReference("systemuser", context.UserId);

                        Entity toParty = new Entity("activityparty");

                        toParty = new EntityReference("contact", entity.Id);

                      

 

                        // Step - 3

                        Entity email = new Entity("email");

                        email = new Entity[] { fromParty };

                        email = new Entity[] { toParty };

                        email = "Welcome to Contoso Inc.";

                        email = "<p>You have been added as a Contact. You are now eligible to redeem our special offers.</p>"; // You can write html emails

                        email = new EntityReference("contact", entity.Id);

                        email = true;

                        Guid emailGuid = Service.Create(email);

 

 

                        // Step - 4

                        SendEmailRequest sendEmailRequest = new SendEmailRequest

                        {

                            EmailId = emailGuid,

                            TrackingToken = "",

                            IssueSend = true

                        };

                        SendEmailResponse sendEmailresp = (SendEmailResponse)Service.Execute(sendEmailRequest);

                        tracingService.Trace("Email Sent");                    }

                }

 

            }

            catch(Exception ex)

            {

                throw new InvalidPluginExecutionException("An error occured while running plugin.", ex);

            }

        }

    }

}


Below is the explanation of the above code -

Step 1:

Firstly, we will extract the context and other important variables from the PluginContext.

Step 2:

In this step we are setting to and from attributes for the email. The to and from attributes are basically the instance of ActivityParty entity in CRM, in which we have to set the partyid attribute which is of type EntityReference. In this example we are setting the fromParty to the user who has called the plugin.

Step 3:

In this step we are creating a record in email entity. In the description attribute you can also add html. The create method returns the GUID of newly created record which we will use to create a send email request.

 

Step 4:

Using step 3 we are creating an email, but it will not send it. To send an email we have to create a SendEmailRequest using the CRM’s inbuilt class which takes email GUID as a parameter. We are using Execute method to execute the request.

Add this plugin on create of Contact entity and if all goes well, you can see the newly created email using advanced find tool in CRM.

If your email settings are correctly configured in the CRM, it will send the email to the user and set the Status Reason to Sent.

.Net
Dynamics CRM
C#
Dynamics 365
Plugin
send-email
Blog Calendar
Blog Calendar List
2025 Feb  7  1
2024 Nov  9  1
2024 Aug  6  1
2024 Apr  54  4
2024 Mar  137  4
2024 Feb  290  3
2024 Jan  31  7
2023 Dec  35  6
2023 Nov  420  5
2023 Oct  548  12
2023 Sep  1386  9
2023 Aug  388  6
2023 Jul  47  6
2023 Jun  26  4
2023 May  44  5
2023 Apr  68  5
2023 Mar  199  6
2023 Feb  162  5
2023 Jan  70  4
2022 Dec  95  7
2022 Nov  286  2
2022 Sep  13  1
2022 Aug  32  2
2022 Jun  11  2
2022 May  6  2
2022 Apr  12  2
2022 Mar  2  1
2022 Feb  2  1
2022 Jan  1  1
2021 Dec  4  1
2021 Nov  2  1
2021 Oct  2  1
2021 Sep  14  1
2021 Aug  49  5
2021 Jul  51  4
2021 Jun  1710  5
2021 May  42  3
2021 Apr  2226  3
2021 Mar  211  5
2021 Feb  2614  7
2021 Jan  3905  9
2020 Dec  544  7
2020 Sep  80  3
2020 Aug  777  3
2020 Jul  135  1
2020 Jun  96  3
2020 Apr  94  3
2020 Mar  19  2
2020 Feb  34  5
2020 Jan  48  7
2019 Dec  17  4
2019 Nov  38  1
2019 Jan  23  2
2018 Dec  118  4
2018 Nov  68  3
2018 Oct  18  3
2018 Sep  1238  11
2018 Aug  7  2
2018 Jun  18  1
2018 Jan  70  2
2017 Sep  589  5
2017 Aug  17  1
2017 Jul  17  2
2017 Jun  64  2
2017 May  21  1
2017 Apr  38  2
2017 Mar  139  4
2017 Feb  835  4
2016 Dec  207  3
2016 Nov  959  8
2016 Oct  321  10
2016 Sep  780  6
2016 Aug  39  1
2016 Jun  1884  6
2016 May  112  3
2016 Jan  72  2
2015 Dec  675  6
2015 Nov  4  1
2015 Oct  13  1
2015 Sep  1471  6
2015 Aug  14  1
2015 Jul  129  2
2015 Jun  11  1
2015 May  20  1
2015 Apr  30  3
2015 Mar  80  3
2015 Jan  5348  4
2014 Dec  18  1
2014 Nov  2260  4
2014 Oct  69  1
2014 Sep  107  2
2014 Aug  5327  1
2014 Jul  49  2
2014 Apr  2593  12
2014 Mar  307  17
2014 Feb  222  6
2014 Jan  1510  16
2013 Dec  21  2
2013 Nov  694  2
2013 Oct  256  3
2013 Sep  11  1
2013 Aug  40  3
2013 Jul  214  1
2013 Apr  61  6
2013 Mar  2371  10
2013 Feb  131  3
2013 Jan  350  2
2012 Nov  61  2
2012 Oct  518  10
Tag Cloud
Interested in our services? Still not sure about project details? get a quote