customFields = new HashMap<>();
customFields.put("firstName", firstName);
recipient.setCustomFields(customFields);
emailMessage.setTo(Arrays.asList(recipient));
emailMessage.setHtmlBody(
"Welcome, {{firstName}}!
" +
"Thank you for joining us. We're excited to have you on board.
" +
"Get started by exploring our features:
" +
"- Feature 1
- Feature 2
- Feature 3
" +
"If you have any questions, just reply to this email.
" +
"Unsubscribe
"
);
emailMessage.setTextBody(
"Welcome, {{firstName}}!\n\n" +
"Thank you for joining us. We're excited to have you on board.\n\n" +
"Get started by exploring our features:\n" +
"- Feature 1\n- Feature 2\n- Feature 3\n\n" +
"If you have any questions, just reply to this email.\n\n" +
"Unsubscribe: {{unsubscribe}}"
);
emailMessage.setGroups(Arrays.asList("welcome"));
emailMessage.setTrackOpens(true);
emailMessage.setTrackClicks(true);
List result = emailApi.sendEmail(apiKey, emailMessage);
return result.get(0);
} catch (ApiException e) {
throw new RuntimeException("Failed to send welcome email: " + e.getMessage(), e);
}
}
public EmailResponse sendPasswordResetEmail(String email, String resetToken, String firstName) {
try {
String resetUrl = appUrl + "/reset-password?token=" + resetToken;
EmailMessage emailMessage = new EmailMessage();
emailMessage.setSubject("Reset Your Password");
From from = new From();
from.setEmail(fromEmail);
from.setName(fromName);
emailMessage.setFrom(from);
To recipient = new To();
recipient.setEmail(email);
recipient.setName(firstName);
Map customFields = new HashMap<>();
customFields.put("firstName", firstName);
customFields.put("resetUrl", resetUrl);
recipient.setCustomFields(customFields);
emailMessage.setTo(Arrays.asList(recipient));
emailMessage.setHtmlBody(
"Hello {{firstName}},
" +
"We received a request to reset your password. Click the button below:
" +
"Reset Password
" +
"Or copy and paste this link: {{resetUrl}}
" +
"This link will expire in 1 hour.
"
);
emailMessage.setGroups(Arrays.asList("password-reset"));
emailMessage.setTrackClicks(true);
List result = emailApi.sendEmail(apiKey, emailMessage);
return result.get(0);
} catch (ApiException e) {
throw new RuntimeException("Failed to send password reset email: " + e.getMessage(), e);
}
}
}
```
## 4. Create REST Controller
Create `src/main/java/com/example/controller/EmailController.java`:
```java Java theme={null}
package com.example.controller;
import com.example.service.EmailService;
import io.sendpost.client.model.EmailResponse;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import java.util.HashMap;
import java.util.Map;
@RestController
@RequestMapping("/api/email")
public class EmailController {
@Autowired
private EmailService emailService;
@PostMapping("/send")
public ResponseEntity sendEmail(@RequestBody EmailRequest request) {
try {
EmailResponse response = emailService.sendEmail(
request.getTo(),
request.getSubject(),
request.getHtmlBody(),
request.getTextBody()
);
Map result = new HashMap<>();
result.put("success", true);
result.put("messageId", response.getMessageId());
return ResponseEntity.ok(result);
} catch (Exception e) {
Map result = new HashMap<>();
result.put("success", false);
result.put("error", e.getMessage());
return ResponseEntity.status(500).body(result);
}
}
@PostMapping("/welcome")
public ResponseEntity sendWelcomeEmail(@RequestBody WelcomeEmailRequest request) {
try {
EmailResponse response = emailService.sendWelcomeEmail(
request.getEmail(),
request.getFirstName()
);
Map result = new HashMap<>();
result.put("success", true);
result.put("messageId", response.getMessageId());
return ResponseEntity.ok(result);
} catch (Exception e) {
Map result = new HashMap<>();
result.put("success", false);
result.put("error", e.getMessage());
return ResponseEntity.status(500).body(result);
}
}
@PostMapping("/password-reset")
public ResponseEntity sendPasswordReset(@RequestBody PasswordResetRequest request) {
try {
EmailResponse response = emailService.sendPasswordResetEmail(
request.getEmail(),
request.getResetToken(),
request.getFirstName()
);
Map result = new HashMap<>();
result.put("success", true);
result.put("messageId", response.getMessageId());
return ResponseEntity.ok(result);
} catch (Exception e) {
Map result = new HashMap<>();
result.put("success", false);
result.put("error", e.getMessage());
return ResponseEntity.status(500).body(result);
}
}
}
```
## 5. Request DTOs
Create DTOs:
```java Java theme={null}
package com.example.dto;
public class EmailRequest {
private String to;
private String subject;
private String htmlBody;
private String textBody;
// Getters and setters
public String getTo() { return to; }
public void setTo(String to) { this.to = to; }
// ... other getters and setters
}
public class WelcomeEmailRequest {
private String email;
private String firstName;
// Getters and setters
}
public class PasswordResetRequest {
private String email;
private String resetToken;
private String firstName;
// Getters and setters
}
```
## 6. Using Async Email Sending
Create async service:
```java Java theme={null}
@Service
public class AsyncEmailService {
@Autowired
private EmailService emailService;
@Async
public CompletableFuture sendEmailAsync(String to, String subject, String htmlBody) {
return CompletableFuture.completedFuture(
emailService.sendEmail(to, subject, htmlBody, null)
);
}
}
```
Enable async:
```java Java theme={null}
@SpringBootApplication
@EnableAsync
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
```
Make sure your sender email domain is verified in your SendPost account before sending emails.
## 7. Next Steps
Explore more examples and use cases:
Learn more about Spring Boot
View the official SDK on GitHub
View a complete working example on GitHub