Kotlin

Kotlin/JVM with Java 17+. Add the Java SDK dependency to your Gradle dependencies block.

Publish a welcome template with name and action_url variables, and create a project API key. Store it as SENDERY_API_KEY on your server.

export SENDERY_API_KEY="your_project_api_key"

Calls are blocking. In a coroutine, run the send inside withContext(Dispatchers.IO) using your application’s coroutine library.

import co.sendery.Sendery

fun main() {
    val sendery = Sendery(System.getenv("SENDERY_API_KEY"))
    val receipt = sendery.send("[email protected]", "welcome", mapOf(
        "name" to "Alex",
        "action_url" to "https://example.com/start"
    ))
    println(receipt.id())
}

Use the returned ID to check delivery status.

val message = sendery.get(receipt.id())
println(message.status())

Use a key such as welcome-123 for one email, and keep the payload unchanged on retries. retry(3) allows up to three additional attempts for temporary failures; send() alone makes one attempt. API failures throw co.sendery.SenderyException; inspect status(), code(), errors(), and retryAfter().

val email = sendery.prepare("[email protected]", "welcome", mapOf(
    "name" to "Alex", "action_url" to "https://example.com/start"
), null, "welcome-123")
val receipt = email.retry(3).send()