{"id":2411,"date":"2021-12-13T10:25:32","date_gmt":"2021-12-13T10:25:32","guid":{"rendered":"https:\/\/helptest.mainbrainer.com\/knowledge-base\/adding-contacts-to-the-crm\/"},"modified":"2022-07-11T12:00:44","modified_gmt":"2022-07-11T12:00:44","slug":"adding-contacts-to-the-crm","status":"publish","type":"ht_kb","link":"https:\/\/www.mainbrainer.com\/hc\/crm\/learn\/adding-contacts\/","title":{"rendered":"CRM Rules for Contact Addition"},"content":{"rendered":"<div class=\"aricle_container\">\n<p>Contacts can be added to the MainBrainer CRM in the following four ways:<\/p>\n<ol>\n<li><a href=\"\/hc\/crm\/contact-import\/\" target=\"_blank\" rel=\"noopener noreferrer\">Contact Import via a CSV file<\/a><\/li>\n<li><a href=\"\/hc\/crm\/signup-form\/\" target=\"_blank\" rel=\"noopener noreferrer\">Via signup forms<\/a><\/li>\n<li><a href=\"\/hc\/crm\/manage\/add-contact-manually\/\" target=\"_blank\" rel=\"noopener noreferrer\">Manual contact creation<\/a><\/li>\n<li><a style=\"color: #0070ba;\" href=\"https:\/\/docs.mainbrainer.com\/developer-portal\/contacts-overview\/\" target=\"_blank\" rel=\"noopener noreferrer\">Via The MainBrainer Public APIs<\/a><\/li>\n<\/ol>\n<p>If the contact being added already exists in the CRM, the existing contact is updated with the incoming details. In an update, any contact fields omitted from the update request will remain as they were. If no such contact exists, a new contact is created with the incoming details.<\/p>\n<p><strong>Depending on which of the above methods is used to create the contacts, the criteria to identify preexisting contacts may differ. Here\u2019s how:<\/strong><\/p>\n<div style=\"padding: 14px 0;\"><\/div>\n<h2>1. Importing contacts via a CSV file<\/h2>\n<p>When <a href=\"\/hc\/popular\/how-to-import-contacts\/\" target=\"_blank\" rel=\"noopener noreferrer\">importing contacts via a CSV file<\/a>, you will be prompted to identify a primary key and a secondary key for the import process. The purpose of these keys is to define the rules for identifying duplicate records that might exist in the CRM.<\/p>\n<p>Let\u2019s say that you define the mobile numbers as the primary key and Email addresses as your secondary key at the time of import. Here\u2019s how it will work:<\/p>\n<h3>Step 1<\/h3>\n<p>The primary key values of the incoming CSV file (mobile numbers in this example) will be compared against those already in the CRM. In case the incoming mobile number already exists in the CRM, the contact is updated with the incoming details.<\/p>\n<h3>Step 2<\/h3>\n<p>For all those primary key values (mobile numbers in this example) for which no records are found in the CRM, we check the CRM for their corresponding secondary key values (Email address in the above example). In case the Email address exists in the CRM, the contact is updated with the incoming details. In case it doesn\u2019t, a new contact is created.<\/p>\n<blockquote class=\"elevio-box-info\"><p><strong>Notes<\/strong>:<\/p>\n<ul style=\"list-style-type: circle;\">\n<li>Specifying the primary key is mandatory to run an import, but specifying the secondary key is optional.<\/li>\n<li>If your business primarily identifies customers by their mobile numbers, i.e., you have distinct customer accounts that share the same Email address but are registered with different mobile numbers, we recommend that you import your contacts with the mobile number as a primary key and no secondary key. This way, contacts will be identified on the basis of their mobile numbers alone, and every new mobile number will be added to the CRM as a unique contact.<\/li>\n<li>Similarly, if your business primarily identifies customers by their Email addresses, we recommend that you import your contacts with the Email address as the primary key and no secondary key.<\/li>\n<\/ul>\n<\/blockquote>\n<div style=\"padding: 14px 0;\"><\/div>\n<h2>2. Add Contact Data via Signup Forms<\/h2>\n<p>For new customer signups via <a href=\"\/hc\/crm\/signup-form\/\" target=\"_blank\" rel=\"noopener noreferrer\">signup forms<\/a>, we compare the incoming mobile numbers from the signups against existing mobile numbers in the CRM. When we do, the following possibilities arise:<\/p>\n<ul style=\"list-style-type: circle;\">\n<li>Customer signs up their email address only\n<ul>\n<li>In case the email address already exists in the CRM, we update the existing CRM contact with the incoming information from the signup form.<\/li>\n<li>In case the email address does not exist in the CRM, we create a new CRM contact with the incoming information from the signup form.<\/li>\n<\/ul>\n<\/li>\n<li>Customer signs up their mobile number only\n<ul>\n<li>In case the Mobile Number already exists in the CRM, we update the existing CRM contact with the incoming information from the signup form.<\/li>\n<li>In case the Mobile Number does not exist in the CRM, we create a new CRM contact with the incoming information from the signup form.<\/li>\n<\/ul>\n<\/li>\n<li>Customer signs up a combination of mobile number and email address\n<ul>\n<li>In this case, if the mobile number from the signup form doesn\u2019t exist in the CRM, we create a new contact in the CRM with the incoming information from the signup form.<\/li>\n<li>In case the mobile number from the signup form already exists in the CRM. In this case, we update the existing CRM contact with the incoming information from the signup form.<\/li>\n<\/ul>\n<\/li>\n<li>In case the signup form doesn&#8217;t have an Email Address or a Mobile Number field and is distributed via SMS with Unique URL(s), we auto-update the incoming information from the signup form against the corresponding mobile number entries in the CRM.<\/li>\n<\/ul>\n<h2><\/h2>\n<h2>3. Manual Contact Creation<\/h2>\n<p>When you <a href=\"\/hc\/crm\/manage\/add-contact-manually\/\" target=\"_blank\" rel=\"noopener noreferrer\">create a contact manually in the CRM<\/a>, we do not run any checks for possible duplicates and add the contacts to the CRM with the entered information.<\/p>\n<p>When creating a new contact manually, if you click&nbsp;<strong>Continue&nbsp;<\/strong>without typing in any contact details, we create a new contact in the CRM with your account&#8217;s default country name alone.<\/p>\n<div style=\"padding: 14px 0;\"><\/div>\n<p><img decoding=\"async\" class=\"alignnone wp-image-1536\" title=\"CRM adding new contact manually\" src=\"https:\/\/www.mainbrainer.com\/hc\/wp-content\/uploads\/2021\/11\/crm-manual-contact-creation.png\" alt=\"CRM, contact adding. Manual contact entry\" width=\"640\"><\/p>\n<div style=\"padding: 24px 0;\"><\/div>\n<h2>4. Via the MainBrainer Public APIs<\/h2>\n<p>The <a style=\"color: #0070ba;\" href=\"https:\/\/docs.mainbrainer.com\/developer-portal\/contacts-overview\/\" target=\"_blank\" rel=\"noopener noreferrer\">MainBrainer Contacts API<\/a> helps you upsert (insert+update) contacts to the CRM. Read our detailed <a style=\"color: #0070ba;\" href=\"https:\/\/docs.mainbrainer.com\/developer-portal\/\" target=\"_blank\" rel=\"noopener noreferrer\">API docs<\/a> to read more about using the APIs.<\/p>\n<\/div>\n<style>\n  .aricle_container p,.aricle_container li{color: rgba(0,0,0,.8)!important}<br \/>\n  .aricle_container span{color:#0070ba!important}<br \/>\n  .aricle_container li,.aricle_container blockquote{font-size:18px!important;font-weight: 400;}<br \/>\n  .aricle_container a{font-size:18px!important;color: #0070BA!important; text-decoration:none!important;background-image:none!important}<br \/>\n<\/style>\n","protected":false},"excerpt":{"rendered":"<p>Contacts can be added to the MainBrainer CRM via a CSV file import, manually, via signup forms,<br \/>\nor via the MainBrainer public APIs.<\/p>\n","protected":false},"author":1,"comment_status":"open","ping_status":"open","template":"","format":"standard","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"footnotes":""},"ht-kb-category":[221],"ht-kb-tag":[],"class_list":["post-2411","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-get-acquainted-with-the-crm"],"_links":{"self":[{"href":"https:\/\/www.mainbrainer.com\/hc\/wp-json\/wp\/v2\/ht-kb\/2411","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.mainbrainer.com\/hc\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.mainbrainer.com\/hc\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.mainbrainer.com\/hc\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.mainbrainer.com\/hc\/wp-json\/wp\/v2\/comments?post=2411"}],"version-history":[{"count":8,"href":"https:\/\/www.mainbrainer.com\/hc\/wp-json\/wp\/v2\/ht-kb\/2411\/revisions"}],"predecessor-version":[{"id":11033,"href":"https:\/\/www.mainbrainer.com\/hc\/wp-json\/wp\/v2\/ht-kb\/2411\/revisions\/11033"}],"wp:attachment":[{"href":"https:\/\/www.mainbrainer.com\/hc\/wp-json\/wp\/v2\/media?parent=2411"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.mainbrainer.com\/hc\/wp-json\/wp\/v2\/ht-kb-category?post=2411"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.mainbrainer.com\/hc\/wp-json\/wp\/v2\/ht-kb-tag?post=2411"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}