iMessage Java & Kotlin SDK

Install

One command to add the iMessage Java SDK to your project.

// Gradle (Kotlin DSL)
dependencies {
    implementation("com.blooio:blooio-sdk:latest.release")
}

// Maven
<dependency>
    <groupId>com.blooio</groupId>
    <artifactId>blooio-sdk</artifactId>
    <version>LATEST</version>
</dependency>

Send your first iMessage

This is the smallest working example — authenticate with your Blooio API key, then call the send-message method on the client.

import com.blooio.Blooio;
import com.blooio.model.SendMessageRequest;

public class Sender {
    public static void main(String[] args) throws Exception {
        Blooio blooio = Blooio.builder()
            .apiKey(System.getenv("BLOOIO_API_KEY"))
            .build();

        blooio.chats().sendMessage(SendMessageRequest.builder()
            .phone("+15551234567")
            .body("Hey Alex — thanks for booking a demo. Reply with any questions.")
            .build());
    }
}

Handle inbound iMessages and webhooks

Every inbound iMessage, delivery, read, and reaction event is POSTed to your webhook URL. Use the SDK's signature verifier to reject forged requests and deserialize the payload into typed objects.

@RestController
@RequestMapping("/webhooks")
public class BlooioWebhookController {

    private final WebhookVerifier verifier =
        new WebhookVerifier(System.getenv("BLOOIO_WEBHOOK_SECRET"));

    @PostMapping(value = "/blooio", consumes = MediaType.APPLICATION_JSON_VALUE)
    public ResponseEntity<Void> handle(
        @RequestHeader("X-Blooio-Signature") String signature,
        @RequestBody byte[] body
    ) {
        try {
            BlooioEvent event = verifier.verify(body, signature);
            if ("message.received".equals(event.type())) {
                MessageReceived data = event.dataAs(MessageReceived.class);
                log.info("inbound iMessage: {}", data.body());
            }
        } catch (InvalidSignatureException e) {
            return ResponseEntity.status(HttpStatus.UNAUTHORIZED).build();
        }
        return ResponseEntity.ok().build();
    }
}

What the SDK gives you on top of raw REST

• Published to Maven Central — pull with Gradle, Maven, or sbt
• Java 17+ and Kotlin 1.9+ supported, Android compatible
• Fluent builders for every request object
• Jackson-based models with typed deserialisation for webhook payloads
• Spring Boot–ready webhook controller example in the docs
• Automatic retries on 429/5xx with exponential backoff

Java iMessage SDK FAQ