Email client

Full reference for the Paubox Java SDK email client: building messages, sending email, tracking delivery, and error handling.

Instantiation

After loading credentials with ConfigurationManager.getProperties(...), create the service:

import com.paubox.service.EmailService;

EmailService service = new EmailService();

Building a message

Messages are built by setting properties on Message, Header, and Content objects, then wiring them together:

import com.paubox.data.*;

Header header = new Header();
header.setFrom("[e-mail]");    // required
header.setSubject("Your results are ready"); // required
header.setReplyTo("[e-mail]"); // optional

Content content = new Content();
content.setPlainText("Plain text body.");    // at least one required
content.setHtmlText("<p>HTML body.</p>");    // optional; auto base64-encoded

Message message = new Message();
message.setRecipients(new String[]{"[e-mail]"}); // required
message.setHeader(header);
message.setContent(content);
message.setCc(new String[]{"[e-mail]"});  // optional
message.setBcc(new String[]{"[e-mail]"});   // optional
message.setAllowNonTLS(false);                        // optional; default false
message.setForceSecureNotification("true");           // optional

Attachments

Base64-encode the file content before setting it on the attachment:

import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.Base64;
import java.util.ArrayList;

byte[] fileBytes = Files.readAllBytes(Paths.get("report.pdf"));
String encoded   = Base64.getEncoder().encodeToString(fileBytes);

Attachment attachment = new Attachment();
attachment.setFileName("report.pdf");
attachment.setContentType("application/pdf");
attachment.setContent(encoded);

ArrayList<Attachment> attachments = new ArrayList<>();
attachments.add(attachment);
message.setAttachments(attachments);

Send a message

SendMessageResponse response = service.sendMessage(message);
System.out.println("Tracking ID: " + response.getSourceTrackingId());

The SendMessageResponse fields:

Method	Description
getSourceTrackingId()	Use to check delivery status
getData()	Raw response data
getErrors()	List of Error objects if the request failed

Check delivery status

GetEmailDispositionResponse disposition =
    service.getEmailDisposition(response.getSourceTrackingId());

for (MessageDeliveries delivery :
     disposition.getData().getMessage().getMessageDeliveries()) {
    System.out.println(
        delivery.getRecipient() + " → " +
        delivery.getStatus().getDeliveryStatus()
    );
}

Common deliveryStatus values: delivered, opened, failed, pending.

Error handling

Both sendMessage and getEmailDisposition declare throws Exception. Wrap calls in a try/catch block:

try {
    SendMessageResponse response = service.sendMessage(message);
    System.out.println("Sent: " + response.getSourceTrackingId());

    if (response.getErrors() != null && !response.getErrors().isEmpty()) {
        for (Error error : response.getErrors()) {
            System.err.println("Error " + error.getCode() + ": " + error.getTitle());
        }
    }
} catch (Exception e) {
    System.err.println("Send failed: " + e.getMessage());
}