Save new Contact to contact list in List Manager

Question

I work with Sitecore 9.1, and I added new contact list from list manager my new list name Subscript_list, I want to save contact information (Email, first name, and Last name) programmatically, I created Form contains the fields (Email, first name, and Last name),I found many articles, but the articles focus to save data to XConnect and send email using EXM Module.

How can I save data from my form directly to my new contact list?

Thanks in Advance.

Answer 1

You should create new Contact and add a new subscription to ListSubscriptions facet.

Create contact:

       public async Task<bool> CreateContact(
            string source,
            string identifier,
            string firstName,
            string lastName,
            string email)
        {
            using (XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient())
            {
                try
                {
                    IdentifiedContactReference reference = new IdentifiedContactReference(source, identifier);

                    var contactTask = client.GetAsync(
                        reference,
                        new ContactExpandOptions()
                    );

                    Contact existingContact = await contactTask;

                    if (existingContact != null)
                    {
                        return false;
                    }

                    var contactIdentifiers = new[]
                    {
                        new ContactIdentifier(source, identifier, ContactIdentifierType.Known),

                    };

                    Contact contact = new Contact(contactIdentifiers);

                    var personal = new PersonalInformation
                    {
                        FirstName = firstName,
                        LastName = lastName
                    };


                    var preferredEmail = new EmailAddress(email, true);
                    var emails = new EmailAddressList(preferredEmail, "Work");

                    client.AddContact(contact);
                    client.SetPersonal(contact, personal);
                    client.SetEmails(contact, emails);

                    await client.SubmitAsync();

                    return true;
                }
                catch (XdbExecutionException ex)
                {
                    _logService.Error(ex.Message, ex);
                    return false;
                }
            }
        }

Subscribe contact to list:

 public async Task<bool> SubscribeContact(string source, string identifier, Guid listId)
        {
            using (XConnectClient client = Sitecore.XConnect.Client.Configuration.SitecoreXConnectClientConfiguration.GetClient())
            {
                try
                {
                    IdentifiedContactReference reference = new IdentifiedContactReference(source, identifier);

                    var contactTask = client.GetAsync(
                        reference,
                        new ContactExpandOptions(
                            ListSubscriptions.DefaultFacetKey
                            )
                    );

                    Contact contact = await contactTask;

                    if (contact == null)
                    {
                        return false;
                    }

                    if (contact.Identifiers.All(x => x.Source != "ListManager"))
                        client.AddContactIdentifier(contact, new ContactIdentifier("ListManager", Guid.NewGuid().ToString(), ContactIdentifierType.Known));

                    var subscriptions = contact.ListSubscriptions() ?? new ListSubscriptions();
                    var subscription = new ContactListSubscription(DateTime.UtcNow, true, listId);
                    subscriptions.Subscriptions.Add(subscription);
                    client.SetListSubscriptions(contact, subscriptions);   

                    await client.SubmitAsync();

                    return true;
                }
                catch (XdbExecutionException ex)
                {
                    _logService.Error(ex.Message, ex);
                    return false;
                }
            }
        }

Answer 2

To update your answer for saving on Stack Exchange, here is a polished version:

---

To add contacts, you need to create a CSV contact list and upload it into the List Manager. Ensure your CSV file includes all required fields such as email, phone number, first name, and last name.

The Contact List is essentially a list of contacts sourced from xConnect. When you update a contact in xConnect, these changes will automatically reflect in the Contact List.