Official Java client for the Reloop API.
- API key — create one in your Reloop account
- Verified domain — add and verify a sending domain; use it in the
fromaddress
Full API reference: reloop.sh/docs
<dependency> <groupId>sh.reloop</groupId> <artifactId>reloop-java</artifactId> <version>2.0.0</version> </dependency>
import sh.reloop.ReloopClient; import sh.reloop.exceptions.ReloopApiException; import sh.reloop.exceptions.ReloopValidationException; import sh.reloop.models.MailModels.SendMailParams; import sh.reloop.models.MailModels.SendMailResponse; public class Example { public static void main(String[] args) { ReloopClient client = new ReloopClient("rl_your_api_key_here"); SendMailParams params = new SendMailParams(); params.from = "Reloop <[email protected]>"; params.to = "[email protected]"; params.subject = "Welcome to Reloop"; params.html = "<p>Thanks for signing up.</p>"; params.text = "Thanks for signing up."; try { SendMailResponse result = client.mail.send(params); System.out.println(result.messageId + " " + result.id); } catch (ReloopValidationException e) { System.err.println("invalid request (" + e.getField() + "): " + e.getMessage()); } catch (ReloopApiException e) { System.err.println("API error " + e.getStatus() + ": " + e.getMessage()); } } }
client.apiKey; // create, list, get, update, delete, rotate, enable, disable client.mail; // send client.domain; // create, list, get, update, delete, verify client.contacts; // CRUD + .properties, .groups, .channels client.webhook; // CRUD, pause/enable/disable, trigger, deliveries + verify client.inbox; // .mailboxes, .messages, .threads
| Kind | Type | When |
|---|---|---|
| Bad client args | ReloopValidationException |
Invalid params — no HTTP call |
| HTTP / network | ReloopApiException |
Non-2xx response or transport failure |
| Webhook HMAC | WebhookSignatureException |
Local signature verification failed |
Idiomatic Java exceptions — the Java equivalent of Node/Python Result objects and Go (T, error).
import sh.reloop.services.WebhookVerify; // payload: the raw request body; signature: the Reloop-Signature request header var event = WebhookVerify.constructEvent(payload, signature, secret, 300); // or client.webhook.verify(params) // event.type, event.createdAt, event.data
Licensed under the Apache License 2.0 with additional use restrictions from Reloop Labs (same as the Reloop project).