Java SDK


The recommended way to install the Unimatrix SDK for Java is with a dependency management tool such as Maven or Gradle, which is available on Maven Central.

Maven users

Add this dependency to your project's pom.xml file:


Gradle users

Add this dependency to your project's build.gradle file:

implementation "com.unimtx:uni-sdk:0.2.0"


The following example shows how to use the Unimatrix Java SDK to interact with Unimatrix services.

Send SMS

Send a text message to a single recipient.

import com.unimtx.Uni;
import com.unimtx.UniException;
import com.unimtx.UniResponse;
import com.unimtx.model.UniMessage;

public class Example {
    public static String ACCESS_KEY_ID = "your access key id";
    private static String ACCESS_KEY_SECRET = "your access key secret";

    public static void main(String[] args) {
        // initialization
        Uni.init(ACCESS_KEY_ID, ACCESS_KEY_SECRET); // if you use the simple auth mode, just pass in the first parameter

        // build a message
        UniMessage message = UniMessage.buildMessage()
            .setTo("your phone number") // in E.164 format
            .setText("Your verification code is 2048.");

        // send the message
        try {
            UniResponse res = message.send();
        } catch (UniException e) {
            System.out.println("Error: " + e);
            System.out.println("RequestId: " + e.requestId);

Send a message using a template with variables.

Map<String, String> templateData = new HashMap<String, String>();
templateData.put("code", "2048");