Upload Attachment

The upload attachment command is used to upload an attachment for sending.

To upload your attachment do a HTTP PUT of your attachment file to:

https://api.elasticemail.com/attachments/upload?username=yourusername&api_key=yourapikey&file=yourfilename

Note: There is currently a limit of 15 MB/attachment.

Once your attachment has been uploaded you will receive an attachment ID back from the request. You can send one or more attachments in your email by referencing the attachment IDs returned. You may use the attachment for up to 48 hours after it has been uploaded. Just add an attachments field to your /mailer/send call:

attachments=semi-colon separated list of attachment IDs

See the modified code samples below which include uploading attachments.

Code Samples

PHP

<?php

$username = urlencode("YOUR ACCOUNT EMAIL ADDRESS");
$apikey = urlencode("YOUR API KEY");

function uploadAttachment($filepath, $filename)
{
    global $username, $apikey;

$res = "";
    $data = file_get_contents($filepath);

$header = "PUT /attachments/upload?username=".$username."&api_key=".$apikey."&file=".$filename." HTTP/1.0\r\n";
    $header .= "Content-Type: application/x-www-form-urlencoded\r\n";
    $header .= "Content-Length: " . strlen($data) . "\r\n\r\n";
    $fp = fsockopen("ssl://api.elasticemail.com", 443, $errno, $errstr, 30);

if(!$fp)
      return "ERROR. Could not open connection";
    else {
      fputs ($fp, $header.$data);
      while (!feof($fp)) {
        $res .= fread ($fp, 1024);
      }
      fclose($fp);
    }
    $res=substr($res,-9);
    return $res;                  
}

function sendElasticEmail($to, $subject, $body_text, $body_html, $from, $fromName, $attachments)
{

global $username, $apikey;

$res = "";

$data = "username=".$username;
    $data .= "&api_key=".$apikey;
    $data .= "&from=".urlencode($from);
    $data .= "&from_name=".urlencode($fromName);
    $data .= "&to=".urlencode($to);
    $data .= "&subject=".urlencode($subject);
    if($body_html)
      $data .= "&body_html=".urlencode($body_html);
    if($body_text)
      $data .= "&body_text=".urlencode($body_text);

if($attachments)
      $data .= "&attachments=".urlencode($attachments);

$header = "POST /mailer/send HTTP/1.0\r\n";
    $header .= "Content-Type: application/x-www-form-urlencoded\r\n";
    $header .= "Content-Length: " . strlen($data) . "\r\n\r\n";
    $fp = fsockopen('ssl://api.elasticemail.com', 443, $errno, $errstr, 30);

if(!$fp)
      return "ERROR. Could not open connection";
    else {
      fputs ($fp, $header.$data);
      while (!feof($fp)) {
        $res .= fread ($fp, 1024);
      }
      fclose($fp);
    }
    return $res;                  
}

$attachId = uploadAttachment("./test.jpg", "test.jpg");
echo sendElasticEmail("test@test.com", "My Subject", "My Text", "My HTML", "you@yourdomain.com", "Your Name", $attachId);

C#

using System;
using System.Collections.Generic;
using System.Collections.Specialized;
using System.Linq;
using System.Text;
using System.Net;
using System.Net.Mail;
using System.IO;

namespace APITest
{
    class Program
    {
        public static string USERNAME = "YOUR ACCOUNT EMAIL ADDRESS";
        public static string API_KEY = "YOUR API KEY";

static void Main(string[] args)
        {
            string from = "samplefrom@yourdomain.com";
            string fromName = "Your Company Name";
            string recipients = "recipient1@gmail.com;recipient2@hotmail.com;recipient3@yahoo.com";
            string subject = "This is a test message.";
            string bodyHtml = "This is the body of the test message. ";

//once an attachment has been uploaded once you can use it in multiple calls to send elastic email.
            string attachment = UploadAttachment(@"D:\Pictures\test-attachment.jpg", "test.jpg");

string result = SendElasticEmail(from, recipients, fromName, subject, bodyHtml, attachment);

Console.WriteLine(result);
            Console.ReadKey();
        }

public static string SendElasticEmail(string from, string to, string fromName, string subject, string bodyHtml, string attachments)
        {
            WebClient client = new WebClient();
            NameValueCollection values = new NameValueCollection();
            values.Add("username", USERNAME);
            values.Add("api_key", API_KEY);
            values.Add("from", from);
            values.Add("from_name", fromName);
            values.Add("subject", subject);
            values.Add("body_html", bodyHtml);
            values.Add("to", to);
            if (attachments != null)
                values.Add("attachments", attachments);
            byte[] response = client.UploadValues("https://api.elasticemail.com/mailer/send", values);
            return Encoding.UTF8.GetString(response);
        }

public static string UploadAttachment(string filepath, string filename)
        {
            FileStream stream = File.OpenRead(filepath);
            WebRequest request = WebRequest.Create("https://api.elasticemail.com/attachments/upload?username=" + USERNAME + "&api_key=" + API_KEY + "&file=" + filename);
            request.Method = "PUT";
            request.ContentLength = stream.Length;
            Stream outstream = request.GetRequestStream();
            stream.CopyTo(outstream, 4096);
            stream.Close();
            WebResponse response = request.GetResponse();
            string result = new StreamReader(response.GetResponseStream(), Encoding.UTF8).ReadToEnd();
            response.Close();
            return result;
        }

}
}

Objective C (iPhone)

// requires third party library ASIHTTPRequest - http://allseeing-i.com/ASIHTTPRequest/

- (void) doUpload
{
    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    NSString *documentsDirectory = [paths objectAtIndex:0];
    NSString *appFile = [documentsDirectory stringByAppendingPathComponent:@"fileToAttach.txt"];
    
    NSURL *url = [NSURL URLWithString:@"https://api.elasticemail.com/attachments/upload"];
    
    ASIFormDataRequest *request = [ASIFormDataRequest requestWithURL:url];
    [request addPostValue:@"USERNAME" forKey:@"username"];
    [request addPostValue:@"API_KEY" forKey:@"api_key"];
    [request addPostValue:appFile forKey:@"file"];
    [request setFile:appFile forKey:@"file"];
    
    [request setCompletionBlock:^{
        NSString *responseString = [request responseString];
        NSLog(@"Upload Response: %@", responseString);
        
        [self doSend];
    }];
    [request setFailedBlock:^{
        NSError *error = [request error];
        NSLog(@"Upload Error: %@", error.localizedDescription);
    }];
    
    [request startAsynchronous];
    
}

- (void) doSend {
    
    NSURL *url = [NSURL URLWithString:@"https://api.elasticemail.com/mailer/send"];
    
    ASIFormDataRequest *request = [ASIFormDataRequest requestWithURL:url];
    [request addPostValue:@"username" forKey:@"username"];
    [request addPostValue:@"api key" forKey:@"api_key"];
    [request addPostValue:@"from email address" forKey:@"from"];
    [request addPostValue:@"to email address" forKey:@"to"];
    [request addPostValue:@"email subject" forKey:@"subject"];
    [request addPostValue:@"email body html" forKey:@"body_html"];
    [request addPostValue:@"fileToAttach.txt" forKey:@"attachments"];
    
    [request setCompletionBlock:^{
        NSString *responseString = [request responseString];
        NSLog(@"Send Response: %@", responseString);
        
        [self doSend];
    }];
    [request setFailedBlock:^{
        NSError *error = [request error];
        NSLog(@"Send Error: %@", error.localizedDescription);
    }];
    
    [request startAsynchronous];
}