- [Home page](https://www.brimit.com/)
- [Blog](https://www.brimit.com/blog)
# Sitecore Send Integration with Sitecore Forms
[Tech Talks](https://www.brimit.com/blog?categories=Tech%20Talks) [DXP](https://www.brimit.com/blog?platforms=DXP)
[Igor Zharikov](https://www.brimit.com/blog/author?authors=Igor%20Zharikov) on November 1, 2022
#### About
In previous [article](https://www.brimit.com/blog/sitecore-send-3-rest-api) we reviewed **Sitecore Send REST API**. So now let's use Sitecore Send together with Sitecore Forms using this API.
Check out my [presentation on SUG Belarus](https://youtu.be/-9DZZ-kWNpc) for more details about this integration.
#### Integration
How Sitecore Send and Sitecore Forms can be integrated? I see the following ways:
- To send emails from Sitecore Platform to customers via [Moosend SMPTP](https://help.moosend.com/hc/en-us/articles/4405943965970-Enable-SMTP-to-send-transactional-emails)
- Create customer in Moosend after form is submitted.
#### Moosend SMTP
You just need to patch Sitecore configuration with the following file:
```
```
`MailServerUserName` and `MailServerPassword` are your Sitecore Send account email and password.
After patch you're able to send emails through Moosend SMTP:
```
using (MailMessage message = new MailMessage())
{
message.From = ...;
message.Subject = ...;
message.Body = ...;
message.IsBodyHtml = true;
message.To.Add(...);
message.CC.Add(...);
message.Bcc.Add(...);
MainUtil.SendMail(message);
}
```
Also OOTB with Sitecore Forms comes `Send Email` submit action, which internally uses configured SMTP - so this submit action can also be used in your forms.
#### `Add User To Mailing List` Submit Action
Submit action works in the following way.
**Form builder**
1. User specifies the mailing list from dropdown, where subscriber should be added
2. Fields mapping is configured (custom fields in Moosend to Sitecore Form fields)
See the demo:
**Submit action**
1. Read parameters: list, fields mapping
2. Map form data to model
3. Add customer to mailing list via [REST API](https://www.brimit.com/blog/sitecore-send-3-rest-api)
##### API Key
**API key** (`Account Settings` -> `API Key` in Moosend) needs to be obtained. See [this article](https://help.moosend.com/hc/en-us/articles/4403735862674-Find-the-API-key-of-your-account) for more details.
DI registration:
```
serviceCollection.AddSingleton((pr) =>
{
var settings = pr.GetService();
return new MoosendSettings()
{
ApiKey = settings.GetSetting("Moosend.ApiKey"),
};
});
```
Usage (see [MailingListService.cs](https://github.com/izharikov/sitecore-moosend-website/blob/master/src/Foundation/Moosend/website/Services/MailingListService.cs)):
```
public MailingListService(IMoosendSettings moosendSettings, ...)
{
_moosendSettings = moosendSettings;
...
}
public IEnumerable GetAll()
{
var response =
_mailingListsApi.GettingAllActiveMailingLists(_moosendSettings.Format, _moosendSettings.ApiKey);
...
}
```
##### Submit Action Editor
1. [Editor structure](https://github.com/izharikov/sitecore-moosend-website/tree/master/src/Foundation/Moosend/serialization/Moosend%20Add%20To%20List)
2. [JS Control](https://github.com/izharikov/sitecore-moosend-website/blob/master/src/Foundation/Moosend/website/sitecore/shell/client/Applications/FormsBuilder/Layouts/Actions/MoosendAddToList.js)
3. [Service API Controller](https://github.com/izharikov/sitecore-moosend-website/blob/master/src/Foundation/Moosend/website/Controllers/MoosendServiceApiController.cs). Don't forget to register controller in DI:
```
serviceCollection.AddTransient();
```
##### Submit Action
Form parameters:
```
public class AddUserToMailingListData
{
public string List { get; set; }
public IDictionary Mapping { get; set; } = new Dictionary();
}
```
[AddUserToMailingList.cs](https://github.com/izharikov/sitecore-moosend-website/blob/master/src/Foundation/Moosend/website/SubmitActions/AddUserToMailingList.cs).
```
protected override bool Execute(AddUserToMailingListData data, FormSubmitContext formSubmitContext)
{
var list = data.List;
// some validation here
// get service:
var service = ServiceLocator.ServiceProvider.GetService();
// mapping:
var name = GetFieldValue(formSubmitContext, nameFieldId) as string;
var tags = GetFieldValue(formSubmitContext, tagsFieldId) as IEnumerable;
var customFields = GetCustomFields(data, formSubmitContext);
// add subscriber to mailing list
var success = service.AddToMailingList(list, email, name, customFields, tags);
return success;
}
```
#### How it all works together
Check out this [video](https://youtu.be/-9DZZ-kWNpc?t=2391) (it's already with demo timecode).
#### Conclusion
With this integration the following features are available:
- SMTP integration
- Dynamic form and properties mapping
All sources are available on my [Git Repo](https://github.com/izharikov/sitecore-moosend-website).
###### Author
Igor Zharikov
Sitecore MVP / Senior Sitecore Developer
[Igor Zharikov](https://www.brimit.com/blog/author?authors=Igor%20Zharikov)
###### More By Categories
[#Events](https://www.brimit.com/blog?categories=#Events) [#How-to](https://www.brimit.com/blog?categories=#How-to) [#News](https://www.brimit.com/blog?categories=#News) [#Guides](https://www.brimit.com/blog?categories=#Guides)
###### More by Platform
[Data and AI](https://www.brimit.com/blog?platforms=Data%20and%20AI) [DXP](https://www.brimit.com/blog?platforms=DXP) [E-commerce](https://www.brimit.com/blog?platforms=E-commerce) [Internet of Things](https://www.brimit.com/blog?platforms=Internet%20of%20Things) [Sales and marketing automation](https://www.brimit.com/blog?platforms=Sales%20and%20marketing%20automation)