Quickstart

Add the Paubox Java SDK and send your first HIPAA compliant email in minutes.

1. Add the JAR

   Download Paubox.Email.API.jar from the repository and add it to your project’s classpath. See Installation for IDE and Maven instructions.

2. Create config.properties

   Create a config.properties file in your project:

   APIKEY=YOUR_API_KEY
   APIUSER=YOUR_USERNAME
   

   To obtain credentials, see Authentication.

3. Load credentials and send an email

   import com.paubox.service.EmailService;
   import com.paubox.data.*;
   import com.paubox.config.ConfigurationManager;
   
   public class SendEmail {
       public static void main(String[] args) throws Exception {
   
           // Load credentials from config.properties
           ConfigurationManager.getProperties("config.properties");
   
           // Build the message
           Header header = new Header();
           header.setFrom("[e-mail]");
           header.setSubject("Your first Paubox email");
   
           Content content = new Content();
           content.setPlainText("This message was sent with the Paubox Java SDK.");
   
           Message message = new Message();
           message.setRecipients(new String[]{"[e-mail]"});
           message.setHeader(header);
           message.setContent(content);
   
           // Send
           EmailService service = new EmailService();
           SendMessageResponse response = service.sendMessage(message);
   
           System.out.println("Sent. Tracking ID: " + response.getSourceTrackingId());
       }
   }
   
4. Check delivery status

   GetEmailDispositionResponse disposition =
       service.getEmailDisposition(response.getSourceTrackingId());
   
   for (MessageDeliveries delivery :
        disposition.getData().getMessage().getMessageDeliveries()) {
       System.out.println(delivery.getRecipient()
           + " → " + delivery.getStatus().getDeliveryStatus());
   }
   

Next steps

• Email client: CC/BCC, attachments, error handling
• Forms client: retrieve form schemas and submit responses