{"type":"doc","content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"This method creates and automatically starts an import process for the contacts listed in the xmlDoc parameter. You can use this method instead of calling a sequence of ","type":"text"},{"text":"NewImportProcess ","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/mailupapi/pages/36340354"}}]},{"text":"and ","type":"text"},{"text":"StartProcess ","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/mailupapi/pages/36340053"}}]},{"text":"methods. ","type":"text"},{"text":"StartImportProcesses","type":"text","marks":[{"type":"em"}]},{"text":" can also be used to update fields of an existing contact. ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Method parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"Mandatory fields must be specified even when they are empty. Optional fields can be skipped if you want to use the default value","type":"text"},{"text":". ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#0000ff"}}]}]},{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"listsIDs","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"string","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Mandatory","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#333399"}}]},{"text":" - List identifiers. You can include multiple list IDs, separated by semicolons.","type":"text"},{"type":"hardBreak"},{"text":"(See \"Lists and Groups\" section below for more information and examples.)","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Example: ","type":"text"},{"text":"1;2;3","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"listsGUIDs","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"string","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Mandatory","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#333399"}}]},{"text":" - List GUIDs. You can include multiple list GUIDs, separated by semicolons.","type":"text"},{"type":"hardBreak"},{"text":"(","type":"text","marks":[{"type":"em"}]},{"text":"See \"Lists and Groups\" section below for more information","type":"text","marks":[{"type":"em"}]},{"text":" and examples","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text","marks":[{"type":"em"}]},{"text":")","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Example: ","type":"text"},{"text":"abc-123-def-456","type":"text","marks":[{"type":"code"}]},{"text":";","type":"text","marks":[{"type":"code"}]},{"text":"ghi-789-jkl-123;","type":"text","marks":[{"type":"code"}]},{"text":"mno-456-pqr-789","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"xmlDoc","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"string","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"When specified:","type":"text","marks":[{"type":"strong"}]},{"text":" An XML string containing the recipients to be imported to the specified lists and groups. In this case the method Does not import any pending lists that were ","type":"text"},{"text":"previously submitted using ","type":"text"},{"text":"NewImportProccess","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/mailupapi/pages/36340354"}}]}]},{"type":"paragraph","content":[{"text":"If not specified (NULL):","type":"text","marks":[{"type":"strong"}]},{"text":" method sequentially imports all pending XML structures that have been previously submitted using ","type":"text"},{"text":"NewImportProccess","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/mailupapi/pages/36340354"}}]},{"text":". This option is available only starting from MailUp 8.2.1 or higher","type":"text"}]},{"type":"paragraph","content":[{"text":"See \"Best Practices\" and \"XML Structure\" sections below for known restrictions, more information and examples.","type":"text","marks":[{"type":"em"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"groupsIDs","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"string","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Mandatory","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#333399"}}]},{"text":" - ","type":"text"},{"text":"Group identifiers for each list, separated by semicolons. You can specify multiple groups for each list as well, separated by commas.","type":"text"},{"type":"hardBreak"},{"text":"(","type":"text","marks":[{"type":"em"}]},{"text":"See \"Lists and Groups\" section below for more information","type":"text","marks":[{"type":"em"}]},{"text":" and examples","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text","marks":[{"type":"em"}]},{"text":")","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Example: ","type":"text"},{"text":"22,23;24;25","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"importType","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"integer","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Mandatory","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#333399"}}]},{"text":" - ","type":"text"},{"text":"Import type.","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Any empty field is ignored if importType is equal to 1,2 or 3","type":"text","marks":[{"type":"underline"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1 = import occur only on email channel (mobile number, if present, is discarded)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"2 = subscriptions occur only on SMS channel (email address, if present, is discarded)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"3 = subscriptions occur on both email and SMS channels (no field is discarded)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Any empty field overwrites the value on MailUp if importType is equal to 4, 5 or 6","type":"text","marks":[{"type":"underline"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"4 = import occur only on email channel (mobile number, if present, is discarded)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"5 = subscriptions occur only on SMS channel (email address, if present, is discarded)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"6 = subscriptions occur on both email and SMS channels (no field is discarded)","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"mobileInputType","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"integer ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Mandatory","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#333399"}}]},{"text":" - ","type":"text"},{"text":"Mobile number input type.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"1 = Entire number in a single field","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"2 = Prefix and Number separated into different fields","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"(See \"XML Structure\" section below for more information and examples.)","type":"text","marks":[{"type":"em"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"asPending","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"boolean","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Mandatory","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#333399"}}]},{"text":" - ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"If ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"\"true\"","type":"text","marks":[{"type":"em"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" it subscribes (or unsubscribes, if ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"\"asOptOut=true\"","type":"text","marks":[{"type":"em"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":") also the recipients that were pending in specified MailUp list before import. Please note that the name of this parameter is misleading, see table in Best Practices for details","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"},{"text":"(Default = false)","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"ConfirmEmail","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"boolean","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Mandatory","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#333399"}}]},{"text":" - ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"If ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"\"true\" ","type":"text","marks":[{"type":"em"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"sets subscription status of specified recipients as \"pending\" and sends them a confirmation email. Status change to \"pending\" and email sending applies to either brand new recipients or to recipients that were already subscribed or pending to the specified list before import. See table in Best Practices for details.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"},{"text":"(Default = false)","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"asOptOut","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"boolean","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Mandatory","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#333399"}}]},{"text":" - ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Imports recipients as \"unsubscribed\" when set to ","type":"text"},{"text":"\"true\"","type":"text","marks":[{"type":"em"}]},{"text":", regardless if they were previously subscribed into specified MailUp list. If you want to cancel subscription (i.e. unsubscribe) also for the ","type":"text"},{"text":"recipients that were ","type":"text"},{"text":"previously pending, you should set both ","type":"text"},{"text":"\"asOptOut=true\" and ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"\"asPending=true\". ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"See table in Best Practices for details.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":"(Default = false)","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"forceOptIn","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"boolean","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Mandatory","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#333399"}}]},{"text":" - If ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"\"true\" ","type":"text","marks":[{"type":"em"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"it","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" ","type":"text","marks":[{"type":"em"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"enables change of subscription status even if a ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"recipient was \"unsubscribed\" before import. It can be used to force \"subscribed\" or \"pending\" status for previously unsubscribed recipients, please note that this status change does not apply when recipient was automatically unsubscribed due to hard bounce or complaints feedback loop","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":". ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"See table in Best Practices for details.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"},{"text":"(Default = false)","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"replaceGroups","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"boolean","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Mandatory","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#333399"}}]},{"text":" - ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Replace existing groups when set to ","type":"text"},{"text":"\"true\"","type":"text","marks":[{"type":"em"}]},{"text":". The system will automatically remove previously subscribed groups and keep only the groups specified in the ","type":"text"},{"text":"groupsIDs","type":"text","marks":[{"type":"code"}]},{"text":" parameter.","type":"text"},{"type":"hardBreak"},{"text":"(Default = false)","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"}]}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The following table shows the most common combinations for the parameters that manage subscription status of imported recipients that are already present on MailUp","type":"text"}]}]},{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Action required on already existing recipients","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"ConfirmEmail","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"AsOptout","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"AsPending","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"ForceOptIn","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"No changes on subscription status","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Default case","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Pending ","type":"text"},{"text":"become ","type":"text"},{"text":"Subscribed ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"True","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"It's a bad practice to force subscription of pending recipients at import time, the recommended ","type":"text"},{"type":"hardBreak"},{"text":"practice with double optin is that you import as pending and you let MailUp do this status change ","type":"text"},{"type":"hardBreak"},{"text":"when recipient actually clicks on the confirmation link.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Unsubscribed ","type":"text"},{"text":"become ","type":"text"},{"text":"Subscribed","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"True","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Except for recipients that were unsubscribed due to hard bounce ","type":"text"},{"type":"hardBreak"},{"text":"or complaints feedback loop","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Subscribed become Pending","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"True","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"With this configuration the confirmation email is sent to both ","type":"text"},{"type":"hardBreak"},{"text":"previously subscribed and previously pending","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Unsubscribed become Pending","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"True","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Any","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"True","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Except for recipients that were unsubscribed due to hard bounce ","type":"text"},{"type":"hardBreak"},{"text":"or complaints feedback loop","type":"text"},{"type":"hardBreak"},{"text":"Despite of its name, \"","type":"text"},{"text":"AsPending","type":"text","marks":[{"type":"em"}]},{"text":"\" value is ignored here.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Subscribed become Unsubscribed","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"True","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Pending become Unsubscribed","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"True","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"True","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"False","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Best practices","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Method call fails when another import process is running. You can use ","type":"text"},{"text":"GetProcessDetails ","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/mailupapi/pages/36342820"}}]},{"text":"method to check if a previously started process is still running; while an alternative solution consist of periodically retry the method call until it returns ReturnCode=0","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Method response contains either a global ReturnCode or a specific ReturnCode for each import process that has been started by this method. Call is successful only when all ReturnCodes are equal to \"0\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"There is not a known size limit for xmlDoc field: it has been successfully tested with 1.2 million characters (in this case return value is quite immediate but the whole import process could take several minutes and other import requests will be denied during this period)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When using cloud services it can happen that your application must respect a size limit in API calls that is lower than the size of the XML that you would pass as xmlDoc parameter. In this case you can split your import data, call several times ","type":"text"},{"text":"NewImportProcess","type":"text","marks":[{"type":"underline"}]},{"text":" ","type":"text"},{"text":"with smaller recipient lists and then use ","type":"text"},{"text":"StartImportProcesses","type":"text","marks":[{"type":"underline"}]},{"text":" (with empty xmlDoc parameter) to sequentially start all previously created import processes. This behavior requires MailUp 8.2.1 or higher. Please note that, when combining one or more calls to ","type":"text"},{"text":"NewImportProcess","type":"text","marks":[{"type":"underline"}]},{"text":" and a final call to ","type":"text"},{"text":"StartImportProcesses","type":"text","marks":[{"type":"underline"}]},{"text":" ","type":"text"},{"text":", the parameters of ","type":"text"},{"text":"StartImportProcesses","type":"text","marks":[{"type":"underline"}]},{"text":" ","type":"text"},{"text":"do not overwrite the import settings that were specified by each ","type":"text"},{"text":"NewImportProcess","type":"text","marks":[{"type":"underline"}]},{"text":" ","type":"text"},{"text":"request","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"With ConfirmEmail=true, MailUp automatically selects the confirmation request message (you can customize it on Settings > List Settings > Notifications > Confirmation request) and it creates a queue of recipients that will receive that message. Please note that queue creation takes a while (even a couple of minutes if you have 1M recipients to be imported and notified) and queued message is made \"ready for immediate sending\" but it IS NOT automatically sent to the recipients. To send a queued message you can use ","type":"text"},{"text":"StartDelivery","type":"text","marks":[{"type":"link","attrs":{"href":"http://help.mailup.com/display/mailupapi/WS_MailUpSend.StartDelivery"}}]},{"text":" method. You could also use ","type":"text"},{"text":"GetNewsletterQueues","type":"text","marks":[{"type":"link","attrs":{"href":"http://help.mailup.com/display/mailupapi/WS_MailUpSend.GetNewsletterQueues"}}]},{"text":" before calling StartDelivery in order to double check if queuing in \"ImmediateSendingQueue\" is completed.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Lists and Groups","type":"text"}]},{"type":"paragraph","content":[{"text":"You must specify either ","type":"text"},{"text":"listIDs","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"listsGUIDs","type":"text","marks":[{"type":"code"}]},{"text":" parameters. If you specify both fields, then the number of items in each parameter must match, and you must use semicolons to delineate empty values. We've provided examples below to help with understanding how to work with these parameters.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Add recipients to a single list (no groups)","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example values are provided for both ","type":"text"},{"text":"listsIDs","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"listsGUIDs","type":"text","marks":[{"type":"code"}]},{"text":" parameters (mandatory fields). There are no groups, so we include an empty ","type":"text"},{"text":"groupsIDs","type":"text","marks":[{"type":"code"}]},{"text":" tag.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html/xml"},"content":[{"text":"1\n66af9900-7dd7-4cca-9125-beadaf3a3a59\n","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Add recipients to a single list (single group)","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example values are provided for both ","type":"text"},{"text":"listsIDs","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"listsGUIDs","type":"text","marks":[{"type":"code"}]},{"text":" parameters (mandatory fields), and since there is a single group we include it in the ","type":"text"},{"text":"groupsIDs","type":"text","marks":[{"type":"code"}]},{"text":" parameter.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html/xml"},"content":[{"text":"66af9900-7dd7-4cca-9125-beadaf3a3a59\n22","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Add recipients to a single list (multiple groups)","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example values are provided for both ","type":"text"},{"text":"listsIDs","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"listsGUIDs","type":"text","marks":[{"type":"code"}]},{"text":" parameters (mandatory fields). There are multiple groups for this list, so we separate them with a comma in the ","type":"text"},{"text":"groupsIDs","type":"text","marks":[{"type":"code"}]},{"text":" parameter.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html/xml"},"content":[{"text":"1\n66af9900-7dd7-4cca-9125-beadaf3a3a59\n22,23 ","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Add recipients to multiple lists (no groups)","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example values are provided for both ","type":"text"},{"text":"listsIDs","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"listsGUIDs","type":"text","marks":[{"type":"code"}]},{"text":" parameters (mandatory fields). Each of the parameters must have the same number of elements ","type":"text"},{"text":"(separated by semi-colons)","type":"text","marks":[{"type":"em"}]},{"text":", so since there are no groups for either list, we include a single semi-colon in the ","type":"text"},{"text":"groupsIDs","type":"text","marks":[{"type":"code"}]},{"text":" parameter to denote that there are two elements.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html/xml"},"content":[{"text":"1;2\n66af9900-7dd7-4cca-9125-beadaf3a3a59;0e591119-xxxx-yyyy-zzzz-6ac75384b564\n;","type":"text"}]},{"type":"heading","attrs":{"level":5},"marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"Add recipients to multiple lists (one group per list)","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"In this example values are provided for both ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"listsIDs","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"listsGUIDs","type":"text","marks":[{"type":"code"}]},{"text":" parameters (mandatory fields). Each of the parameters must have the same number of elements ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"(separated by semi-colons)","type":"text","marks":[{"type":"em"},{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":". In this case, we are also specifying group 22 for list 1, and group 13 for list 2.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]},{"type":"codeBlock","attrs":{"language":"html/xml"},"content":[{"text":"1;2\n66af9900-7dd7-4cca-9125-beadaf3a3a59;0e591119-xxxx-yyyy-zzzz-6ac75384b564\n22;13","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Add recipients to multiple lists (multiple groups)","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example values are provided for both ","type":"text"},{"text":"listsIDs","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"listsGUIDs","type":"text","marks":[{"type":"code"}]},{"text":" parameters (mandatory fields). The first list ","type":"text"},{"text":"(ID=1)","type":"text","marks":[{"type":"em"}]},{"text":" has two groups ","type":"text"},{"text":"(22,23)","type":"text","marks":[{"type":"em"}]},{"text":", so we use a comma to separate them in the first element. We then use a semi-colon to denote the second element, since the groupsIDs, listsIDs and listsGUIDs parameters must all have the same number of elements","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html/xml"},"content":[{"text":"1;2\n66af9900-7dd7-4cca-9125-beadaf3a3a59;0e591119-xxxx-yyyy-zzzz-6ac75384b564\n22,23;13","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"hardBreak"},{"text":"XML Structure","type":"text"}]},{"type":"paragraph","content":[{"text":"The XML structure for each recipient needs to be consistent for all subscribers, and include empty tags for required values that are empty. When specifying the phone number for a recipient, the structure of your XML must match the ","type":"text"},{"text":"mobileInputType","type":"text","marks":[{"type":"code"}]},{"text":" parameter, where either the entire phone number is represented in a single attribute, or the prefix and number are represented in separate attributes. ","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, if the ","type":"text"},{"text":"mobileInputType","type":"text","marks":[{"type":"code"}]},{"text":" parameter is set to ","type":"text"},{"text":"1","type":"text","marks":[{"type":"code"}]},{"text":",use the following XML structure:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html/xml"},"content":[{"text":"\n","type":"text"}]},{"type":"paragraph","content":[{"text":"If the ","type":"text"},{"text":"mobileInputType","type":"text","marks":[{"type":"code"}]},{"text":" parameter is set to ","type":"text"},{"text":"2","type":"text","marks":[{"type":"code"}]},{"text":", use the following XML structure:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html/xml"},"content":[{"text":"\n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"In case you also need to specify personal data fields an example is provided below ","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Personal data fields shall be specified in ","type":"text"},{"text":"progressive order","type":"text","marks":[{"type":"strong"}]},{"text":" and you shall also include empty fields. It is also recommended to use the same data structure (i.e.","type":"text"},{"text":" the same number of fields for each record","type":"text","marks":[{"type":"strong"}]},{"text":", even if some fields are empty) for all subscribers. In case of update of an existing subscriber, the empty fields are handled as \"don't change this field\" when you specify 1, 2 or 3 as ","type":"text"},{"text":"ImportType. ","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do not exceed 50 characters for \"email\" field and 100 characters for \"campo\" fields (up to 200 characters are allowed if you use only 7-bit ASCII strings)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you want to update an existing subscriber and clear one or more of its fields you shall use import type with value 4, 5, or 6; in this case any empty field in xmlDoc parameter resets the correspondent field on MailUp console account.","type":"text"}]}]}]}]},{"type":"codeBlock","attrs":{"language":"html/xml"},"content":[{"text":"\n \n Mike\n Brown\n Example Company\n Los Angeles\n \n 90125\n CA\n US\n 555 Some Street\n \n 555-123-1234\n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"You can use ","type":"text"},{"text":"0","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"1","type":"text","marks":[{"type":"code"}]},{"text":" in place of ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"false","type":"text"},{"text":" for boolean parameter values.","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Unsupported characters in subscribers fields","type":"text"}]},{"type":"paragraph","content":[{"text":"All field values are handled as strings, character '|' (pipe) is not allowed and may lead to \"-402\" error codes","type":"text"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"SOAP Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"An example SOAP request to ","type":"text"},{"text":"StartImportProcesses","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html/xml"},"content":[{"text":"\n \n \n user\n passwordUTF-8\n \n \n \n \n 1\n 66af9900-xxxx-yyyy-zzzz-beadaf3a3a59\n \n <subscribers><subscriber email="mike@example.com" Prefix="" Number="" Name=""><campo1>Mike</campo1><campo2>Brown</campo2><campo3>Example Company</campo3><campo4>Los Angeles</campo4><campo5></campo5><campo6>90125</campo6><campo7>CA</campo7><campo8>US</campo8><campo9>711 Some Street</campo9><campo10></campo10><campo11>555-123-1234</campo11></subscriber></subscribers>\n \n \n 3\n 1\n false\n true\n false\n false\n false\n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"An example SOAP response returned by ","type":"text"},{"text":"StartImportProcess","type":"text","marks":[{"type":"code"}]},{"text":" method. Response may contain more than one ","type":"text"},{"text":"process","type":"text","marks":[{"type":"code"}]},{"text":" element, depending on how many lists were specified as input parameters","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html/xml"},"content":[{"text":"\n \n \n \n \n\t \n\t 0\n\t \n\t\t\n\t\t 69\n\t\t 1\n\t\t 0\n\t\t\n\t\t\n\t\t 70\n\t\t 2\n\t\t 0\n\t \n\t \n\t \n ]]>\n \n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"E","type":"text"},{"text":"rror codes","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Below is a list of the ","type":"text"},{"text":"ReturnCode","type":"text","marks":[{"type":"code"}]},{"text":" values, and what they mean when an error is encountered.","type":"text"}]},{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Error code","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"-200","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"unrecognized error","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" (it is likely that a mandatory parameter is missing)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"-400","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"unrecognized error","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"-401","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"xmlDoc is empty","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"-402","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"convert xml to csv failed","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"-403","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"create new import process failed","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"-410","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"can not create confirmation email","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"-450","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"listsIDs and listsGUIDs must contain the same number of elements","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"-600","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"unrecognized error","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"-601","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"an import process is already running for the list","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"-602","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"an import process is already running for a different list","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"-603","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"error checking process status","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"-604","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"error starting the process job","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Code Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"The code examples below are provided on an \"as is\" basis, without any warranty of any kind. MailUp shall not be held liable for any direct, indirect or consequential damages or costs of any type arising out of any action taken by you or other related to the example code. Please contact us if you are interested in submitting examples for programming languages that are not already included below.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Ruby","type":"text"}]},{"type":"codeBlock","attrs":{"language":"ruby"},"content":[{"text":"# Refer to https://mailup.atlassian.net/wiki/display/mailupapi/MailUp+RubyGem for gem information.\n\nrequire 'mail up'\nm = MailUp::Import.new('username', 'password', 'console_url')\nm.start_import_processes(\n listsIDs: \"1;2;3\",\n listsGUIDs: \"abc123;def456;ghi789\",\n xmlDoc: xml_data_string,\n groupsIDs: '',\n importType: 3,\n mobileInputType: 1\n)\n# => 0...","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"PHP","type":"text"}]},{"type":"codeBlock","attrs":{"language":"php"},"content":[{"text":" with the host name of your console\n protected $WSDLUrl = \"http:///services/WSMailUpImport.asmx?WSDL\";\n protected $headers = array(\"User\" => \"user\", \"Password\" => \"password\");\n protected $rCode;\n private $soapClient;\n private $xmlResponse;\n protected $domResult;\n\n function __construct() {\n $this->header = new SOAPHeader($this->ns, \"Authentication\", $this->headers);\n $this->soapClient = new SoapClient($this->WSDLUrl,array(\"trace\" => 1,\"exceptions\" => 0));\n $this->soapClient->__setSoapHeaders($this->header);\n }\n\n function __destruct() {\n unset($this->soapClient); \n }\n\n //...\n\t\n public function startImportProcesses($processData) {\n try {\n echo $processData.\"

\";\n $this->soapClient->StartImportProcesses($processData);\n } catch (SoapFault $soapFault) {\n var_dump($soapFault);\n }\n }\n\n //...\n\t\n}\n\n$WsImport = new MailUpWsImport();\n$xmlData = <<\nLuigiRossiRossi consultingParma2PR\n43102ITAVia Garibaldi, 10521123456\n0521123457\nEOT;\n\n$startImportProcessData = array(\n \"listsIDs\" => \"4\",\n \"listsGUIDs\" => \"3c5cb08c-f0b5-4bd6-9c2a-b687ecdac8b4\",\n \"xmlDoc\" => $xmlData,\n \"groupsIDs\" => \"22\",\n \"importType\" => \"3\",\n \"mobileInputType\" => \"2\",\n \"asPending\" => '0',\n \"ConfirmEmail\" => \"0\",\n \"asOptOut\" => \"0\",\n \"forceOptIn\" => \"0\",\n \"replaceGroups\" => \"0\"\n);\n \n$WsImport->startImportProcesses($startImportProcessData);\n\n?>","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"C#","type":"text"}]},{"type":"codeBlock","attrs":{"language":"csharp"},"content":[{"text":"WSMailUpImport toTest = new WSMailUpImport();\n\nAuthentication auth = new Authentication();\nauth.User = tbLoginUserImport.Text;\nauth.Password = tbLoginPasswordImport.Text;\nauth.encType = string.Empty;\n\ntoTest.AuthenticationValue = auth;\n\nstring xmlString = \"MikeBrownExample CompanyLos Angeles90125CAUS555 Some Street555-123-1234\";\n\nstring myListId = \"8\";\nstring myListGuid = \"CC9C4CBD-567B-4248-B56F-7C8364F11C5\";\nstring myGroupsIDs = \"45\";\nint importType = 3;\nint mobileInputType = 2;\nbool asPending = false;\nbool ConfirmEmail = false;\nbool asOptOut = false;\nbool forceOptIn = false;\nbool replaceGroups = false;\nstring retVal = toTest.StartImportProcesses(myListId ,myListGuid, xmlString, myGroupsIDs, importType, mobileInputType, asPending , ConfirmEmail, asOptOut, forceOptIn, replaceGroups);","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"type":"hardBreak"}]}],"version":1}