{"id":828,"date":"2022-01-14T17:01:45","date_gmt":"2022-01-14T17:01:45","guid":{"rendered":"https:\/\/logicbuilder.integroscrm.com\/help\/?page_id=828"},"modified":"2022-11-02T13:36:36","modified_gmt":"2022-11-02T13:36:36","slug":"add-email-address","status":"publish","type":"page","link":"https:\/\/logicbuilder.integroscrm.com\/help\/add-email-address\/","title":{"rendered":"Add Email Address"},"content":{"rendered":"\n<p><a name=\"abstract\"><\/a>Adds e-mail address to a record in a field with a type e-mail address. Out-of-the-box entities with Email Addresses are Lead, Contact, Account, Target.<\/p>\n\n\n\n<p><strong>inputs:<\/strong><\/p>\n\n\n\n<p><span style=\"color:#ef6950;\">entity<\/span> &#8211; input entity to which a new Email address must be added<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Required: yes<\/li>\n<\/ul>\n\n\n\n<p><span style=\"color:#9ed267;\">email address<\/span> &#8211; link or specify directly in the operator a new Email Address to add<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Required: yes<\/li>\n<\/ul>\n\n\n\n<p><span style=\"color:#deb7ca;\">primary<\/span> &#8211; input boolean&nbsp;<em>true<\/em>&nbsp;if new email address must be marked as primary. By default is&nbsp;<em>false<\/em>.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Required: no<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-beb4b895a67c429cba9e2e3500fffd61.png\" alt=\"\" class=\"wp-image-833\" width=\"401\" height=\"66\" srcset=\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-beb4b895a67c429cba9e2e3500fffd61.png 465w, https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-beb4b895a67c429cba9e2e3500fffd61-300x50.png 300w\" sizes=\"auto, (max-width: 401px) 100vw, 401px\" \/><\/figure>\n\n\n\n<p><span style=\"color:#deb7ca;\">reply to<\/span> &#8211; input boolean&nbsp;<em>true<\/em>&nbsp;if new email address must be marked as a reply to. By default is&nbsp;<em>false<\/em>.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Required: no<\/li>\n<\/ul>\n\n\n\n<p><span style=\"color:#deb7ca;\">invalid<\/span> &#8211; input boolean&nbsp;<em>true<\/em>&nbsp;if new email address must be marked as an invalid. By default is&nbsp;<em>false<\/em>.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Required: no<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-d928a755fa16426aa0911e42afb3f738.png\" alt=\"\" class=\"wp-image-834\" width=\"376\" height=\"62\" srcset=\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-d928a755fa16426aa0911e42afb3f738.png 465w, https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-d928a755fa16426aa0911e42afb3f738-300x50.png 300w\" sizes=\"auto, (max-width: 376px) 100vw, 376px\" \/><\/figure>\n\n\n\n<p><span style=\"color:#deb7ca;\">opt out<\/span> &#8211; input boolean&nbsp;<em>true<\/em>&nbsp;if new email address must be marked as an opt out. By default is&nbsp;<em>false<\/em>.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Required: no<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-25cc5e61c685460484dbe31c60036a21.png\" alt=\"\" class=\"wp-image-830\" width=\"393\" height=\"65\" srcset=\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-25cc5e61c685460484dbe31c60036a21.png 465w, https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-25cc5e61c685460484dbe31c60036a21-300x50.png 300w\" sizes=\"auto, (max-width: 393px) 100vw, 393px\" \/><\/figure>\n\n\n\n<p><strong>outputs:<\/strong><\/p>\n\n\n\n<p><span style=\"color:#ef6950;\">entity<\/span> &#8211; the entity with the newly added e-mail address<\/p>\n\n\n\n<p><em>Let\u2019s say that there are Contact details retrieved via REST and you would like to update email address based on the response. The flowchart which implements this may be like this:<\/em><\/p>\n\n\n<p><a href=\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-3e67e4ee54da461f800e5378300f3e60.png\" rel=\"prettyPhoto\"><img decoding=\"async\" src=\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-3e67e4ee54da461f800e5378300f3e60-1024x306.png\" alt=\"\" class=\"wp-image-378\"><\/a><\/p>\n<div style=\"background-color: #ddeaff; border-left: 6px solid #0072b3; padding: 12px;\">\n<p><b>Change Primary Email Address<\/b><\/p>\n<p><em>Scenario 1: Set Email Address for the new record<\/em><\/p>\n<p><span style=\"font-size: 1rem;\">For the new record, you may use a field email1 to set a primary email address:<\/span><\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-831\" src=\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-a46ef23cdbec41cf95565a912f57add8.png\" alt=\"\" width=\"588\" height=\"281\" srcset=\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-a46ef23cdbec41cf95565a912f57add8.png 804w, https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-a46ef23cdbec41cf95565a912f57add8-300x143.png 300w, https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-a46ef23cdbec41cf95565a912f57add8-768x367.png 768w\" sizes=\"auto, (max-width: 588px) 100vw, 588px\" \/><\/p>\n<p>Or new operator <span style=\"color: #ec8f45;\">Add Email<\/span>:<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-829\" src=\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-11c144dafb444f2688a0f61c31875270.png\" alt=\"\" width=\"615\" height=\"322\" srcset=\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-11c144dafb444f2688a0f61c31875270.png 728w, https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-11c144dafb444f2688a0f61c31875270-300x157.png 300w\" sizes=\"auto, (max-width: 615px) 100vw, 615px\" \/><\/p>\n<p><em>Scenario 2: changing Email address if there is an email address<\/em><\/p>\n<p>To completely override a Primary Email Address, firstly remove the current Primary Email Address and then set the new one:<\/p>\n<p><a href=\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-db0537a3b8b24ce497ff1b0530608ebe.png\" rel=\"prettyPhoto\"><img decoding=\"async\" src=\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/01\/img-77-db0537a3b8b24ce497ff1b0530608ebe-1024x291.png\" alt=\"\" class=\"wp-image-378\"><\/a><\/p>\n<p><em>N.B. If there is more than one email address for the Record, removing only the Primary address as in the example above may end up with two primary addresses for the record.<\/em><\/p>\n<p><em>To save all email addresses and change only the primary email address (along with preserving the old primary email address), it\u2019s needed to remove all addresses, add a new one, and then return all removed emails, like this:<\/em><\/p>\n<p><a href=\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/11\/add_email_address4.png\" rel=\"prettyPhoto\"><img decoding=\"async\" src=\"https:\/\/logicbuilder.integroscrm.com\/help\/wp-content\/uploads\/2022\/11\/add_email_address4.png\" alt=\"\" class=\"wp-image-378\"><\/a><\/p>\n<\/div><div style=\"text-align:left\" class=\"yasr-auto-insert-visitor\"><!--Yasr Visitor Votes Shortcode--><div id='yasr_visitor_votes_828' class='yasr-visitor-votes'><div class=\"yasr-custom-text-vv-before yasr-custom-text-vv-before-828\">Click to rate this post!<\/div><div id='yasr-vv-second-row-container-2f6c0a390c19e' \n                                        class='yasr-vv-second-row-container'><div id='yasr-visitor-votes-rater-2f6c0a390c19e'\n                                      class='yasr-rater-stars-vv'\n                                      data-rater-postid='828' \n                                      data-rating='0'\n                                      data-rater-starsize='24'\n                                      data-rater-readonly='false'\n                                      data-rater-nonce='fa81b01ba5' \n                                      data-issingular='false'\n                                    ><\/div><div class=\"yasr-vv-stats-text-container\" id=\"yasr-vv-stats-text-container-2f6c0a390c19e\"><svg xmlns=\"https:\/\/www.w3.org\/2000\/svg\" width=\"20\" height=\"20\" \n                               class=\"yasr-dashicons-visitor-stats\"\n                               data-postid=\"828\" \n                               id=\"yasr-stats-dashicon-2f6c0a390c19e\">\n                            <path d=\"M18 18v-16h-4v16h4zM12 18v-11h-4v11h4zM6 18v-8h-4v8h4z\"><\/path>\n                          <\/svg><span id=\"yasr-vv-text-container-2f6c0a390c19e\" class=\"yasr-vv-text-container\">[Total: <span id=\"yasr-vv-votes-number-container-2f6c0a390c19e\">0<\/span>  Average: <span id=\"yasr-vv-average-container-2f6c0a390c19e\">0<\/span>]<\/span><\/div><div id='yasr-vv-loader-2f6c0a390c19e' class='yasr-vv-container-loader'><\/div><\/div><div id='yasr-vv-bottom-container-2f6c0a390c19e' class='yasr-vv-bottom-container'><\/div><\/div><!--End Yasr Visitor Votes Shortcode--><\/div>","protected":false},"excerpt":{"rendered":"<p>Adds e-mail address to a record in a field with a type e-mail address. Out-of-the-box entities with Email Addresses are Lead, Contact, Account, Target. inputs: entity &#8211; input entity to which a new Email address must be added email address &#8211; link or specify directly in the operator a new Email Address to add primary &hellip;<\/p>\n<p class=\"read-more\"> <a class=\"\" href=\"https:\/\/logicbuilder.integroscrm.com\/help\/add-email-address\/\"> <span class=\"screen-reader-text\">Add Email Address<\/span> Read More &raquo;<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"yasr_overall_rating":0,"yasr_post_is_review":"","yasr_auto_insert_disabled":"","yasr_review_type":"","footnotes":""},"tags":[],"class_list":["post-828","page","type-page","status-publish","hentry"],"yasr_visitor_votes":{"number_of_votes":0,"sum_votes":0,"stars_attributes":{"read_only":false,"span_bottom":false}},"_links":{"self":[{"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/pages\/828","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/comments?post=828"}],"version-history":[{"count":5,"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/pages\/828\/revisions"}],"predecessor-version":[{"id":2176,"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/pages\/828\/revisions\/2176"}],"wp:attachment":[{"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/media?parent=828"}],"wp:term":[{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/logicbuilder.integroscrm.com\/help\/wp-json\/wp\/v2\/tags?post=828"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}