Framework Integrations

Spring Boot integration

Send transactional email from your Spring Boot application with Sendery.

Install

<dependency>
  <groupId>co.sendery</groupId>
  <artifactId>sendery-spring-boot-starter</artifactId>
  <version>0.1.4</version>
</dependency>

Source code

Requirements

Spring Boot 4.1 and Java 17+.

Configure your application

Create a project API key and store it as SENDERY_API_KEY. Add this property to application.properties.

application.properties

# application.properties
sendery.api-key=${SENDERY_API_KEY}

Send an email

Call this service with the recipient, published template key, variables, and a unique key for the email. Keep them unchanged on retries. The returned SendReceipt contains id() and status().

Java

import co.sendery.Sendery;
import co.sendery.SendReceipt;
import org.springframework.stereotype.Service;
import java.util.Map;

@Service
public class TemplateEmails {
    private final Sendery sendery;

    public TemplateEmails(Sendery sendery) {
        this.sendery = sendery;
    }

    public SendReceipt send(String to, String template, Map<String, Object> data, String emailKey) {
        return sendery.prepare(to, template, data, null, emailKey).retry(3).send();
    }
}

Retrieve status and handle errors

Use sendery.get(id) to retrieve status. API failures throw SenderyException; inspect status(), code(), errors(), and retryAfter(). Calls are blocking. The starter provides the Sendery template client; it does not configure JavaMailSender.

Send a specific version

Choose a published template version to keep sending it after newer versions are published. By default, Sendery uses the latest version.

Java

import co.sendery.Sendery;
import co.sendery.SendReceipt;
import org.springframework.stereotype.Service;
import java.util.Map;

@Service
public class TemplateEmails {
    private final Sendery sendery;

    public TemplateEmails(Sendery sendery) {
        this.sendery = sendery;
    }

    public SendReceipt send(String to, String template, Map<String, Object> data, String emailKey) {
        return sendery.prepare(to, template, data, null, emailKey).version(3).send();
    }
}

Attachments

Pass a list of Attachment objects to your injected Sendery client. The SDK handles base64 encoding.

Send up to 10 files totaling 5 MB. See the attachment reference for supported formats and limits.

Example

import co.sendery.Attachment;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.List;
import java.util.Map;

var file = Files.readAllBytes(Path.of("document.pdf"));

sendery.prepare(
    "[email protected]",
    "your-template",
    Map.of("name", "Alex", "action_url", "https://example.com/start"),
    null,
    "your-idempotency-key",
    List.of(new Attachment("document.pdf", file, "application/pdf"))
).retry().send();