Published — v. 19
WS_MailUpSend.SendNewsletterFast
Creates and sends a message via a unique call
The "Fast" suffix in the method's name means that you can do two actions with a single call, but there is no performance improvement by using it. Instead, you must pay attention to the very tight rate limits of this method
Method parameters
- string SendNewsletterFast(string accessKey, int listID, string subject, string type, string content, Option[] options)
- accessKey: access key obtained using the LoginFromId method
- listID: list identifier. Lists and corresponding IDs can be obtained calling the GetLists Method
- subject: subject of the message
- type: type of message text (HTML, URL, FILE, TEXT)
- content: message text source, depending on the type:
- type = HTML, content is the HTML code of the message
- type = TEXT, content is the PLAIN-TEXT of the message (this value is deprecated and it is handled exactly as "HTML")
- type = URL, content is the url from which to draw the HTML code of the message
- type = FILE, content is a byte array from which to draw the HTML code of the message
- options: an array of key/value pairs for options setting. All the options listed for the WS_MailUpSend.CreateNewsletter and WS_MailUpSend.SendNewsletter are available for this method as well.
If error code=0, the message will contain the ID of the sending
SOAP Examples
SOAP Request (type = URL, send_to = GROUPS)
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ws="http://services.mailupnet.it/WS"> <soap:Header/> <soap:Body> <ws:SendNewsletterFast> <ws:accessKey>HzAgwRRJaAKBtkgNWpkAuURfV4SxMm6T3HJegRuSkUivKJElNNcmSQe8nqGyoM9S8EyQZb6ZE2s</ws:accessKey> <ws:listID>48</ws:listID> <ws:subject>Hello [FirstName], your subscription is active</ws:subject> <ws:type>URL</ws:type><ws:content>http://www.mailup.it</ws:content> <ws:options> <ws:Option> <ws:Key>note</ws:Key> <ws:Value>my notes</ws:Value> </ws:Option> <ws:Option> <ws:Key>dyn_fld</ws:Key><ws:Value>true</ws:Value> </ws:Option> <ws:Option> <ws:Key>emb_img</ws:Key><ws:Value>false</ws:Value> </ws:Option> <ws:Option> <ws:Key>link_track</ws:Key> <ws:Value>true</ws:Value> </ws:Option> <ws:Option> <ws:Key>track_http</ws:Key> <ws:Value>true</ws:Value> </ws:Option> <ws:Option> <ws:Key>track_https</ws:Key> <ws:Value>true</ws:Value> </ws:Option> <ws:Option> <ws:Key>track_mailto</ws:Key> <ws:Value>true</ws:Value> </ws:Option> <ws:Option> <ws:Key>track_ftp</ws:Key> <ws:Value>true</ws:Value> </ws:Option> <ws:Option> <ws:Key>track_news</ws:Key> <ws:Value>true</ws:Value> </ws:Option> <ws:Option> <ws:Key>link_params</ws:Key> <ws:Value>""</ws:Value> </ws:Option> <ws:Option> <ws:Key>conf_msg</ws:Key> <ws:Value>false</ws:Value> </ws:Option> <ws:Option> <ws:Key>from_name</ws:Key> <ws:Value>Your Dealer</ws:Value> </ws:Option> <ws:Option> <ws:Key>from_email</ws:Key> <ws:Value>jimmy@example.com</ws:Value> </ws:Option> <ws:Option> <ws:Key>clear_stats</ws:Key> <ws:Value>false</ws:Value> </ws:Option> <ws:Option> <ws:Key>send_to</ws:Key> <ws:Value>GROUPS</ws:Value> </ws:Option> <ws:Option> <ws:Key>recipients</ws:Key> <ws:Value>347</ws:Value> </ws:Option> </ws:options> </ws:SendNewsletterFast> </soap:Body> </soap:Envelope>
SOAP Request (type = HTML, send_to = RECIPIENTS)
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ws="http://services.mailupnet.it/WS"> <soap:Header/> <soap:Body> <ws:SendNewsletterFast> <ws:accessKey>HzAgwRRJaAKBtkgNWpkAuURfV4SxMm6T3HJegRuSkUivKJElNNcmSQe8nqGyoM9S8EyQZb6ZE2s<</ws:accessKey> <ws:listID>48</ws:listID> <ws:subject>Hello [FirstName], your subscription is active</ws:subject> <ws:type>HTML</ws:type> <ws:content>Hello [FirstName] [LastName] </br > your request has been approved and your customer code is 0123456789 </ws:content> <ws:options> <ws:Option> <ws:Key>note</ws:Key> <ws:Value>my notes</ws:Value> </ws:Option> <ws:Option><ws:Key>dyn_fld</ws:Key><ws:Value>true</ws:Value></ws:Option> <ws:Option><ws:Key>emb_img</ws:Key><ws:Value>false</ws:Value></ws:Option> <ws:Option> <ws:Key>link_track</ws:Key> <ws:Value>true</ws:Value> </ws:Option> <ws:Option> <ws:Key>track_http</ws:Key> <ws:Value>true</ws:Value> </ws:Option> <ws:Option> <ws:Key>track_https</ws:Key> <ws:Value>true</ws:Value> </ws:Option> <ws:Option> <ws:Key>track_mailto</ws:Key> <ws:Value>true</ws:Value> </ws:Option> <ws:Option> <ws:Key>track_ftp</ws:Key> <ws:Value>true</ws:Value> </ws:Option> <ws:Option> <ws:Key>track_news</ws:Key> <ws:Value>true</ws:Value> </ws:Option> <ws:Option> <ws:Key>link_params</ws:Key> <ws:Value>""</ws:Value> </ws:Option> <ws:Option> <ws:Key>conf_msg</ws:Key> <ws:Value>false</ws:Value> </ws:Option> <ws:Option> <ws:Key>from_name</ws:Key> <ws:Value>Your Dealer</ws:Value> </ws:Option> <ws:Option> <ws:Key>from_email</ws:Key> <ws:Value>jimmy@example.com</ws:Value> </ws:Option> <ws:Option> <ws:Key>clear_stats</ws:Key> <ws:Value>false</ws:Value> </ws:Option> <ws:Option> <ws:Key>send_to</ws:Key> <ws:Value>RECIPIENTS</ws:Value> </ws:Option> <ws:Option> <ws:Key>recipients</ws:Key> <ws:Value>john@example.com;mary@mailup.com</ws:Value> </ws:Option> </ws:options> </ws:SendNewsletterFast> </soap:Body> </soap:Envelope>
SOAP Response
<SendNewsletterFastResult> <errorCode>0</errorCode> <errorDescription>0</errorDescription> <listID>1</listID> <newsletterID>1</newsletterID> <deliveryID>125</deliveryID> <deliveryStatus>Sending in progress</deliveryStatus> </SendNewsletterFastResult>