Add to existing project

You already have a service that posts webhooks to your customers with a hand-built JSON body and some HTTP client. This guide replaces one of those calls with a generated, type-safe sender: no rewrite, no big bang. Set aside about 15 minutes.

You start from something like this, scattered wherever an event happens:

Copy// The ad-hoc send you have today.
val body = """{"type":"order.created","data":{"id":"${order.id}"}}"""
httpClient.post(customer.webhookUrl) { setBody(body) }

The runtime is published to Maven Central under sh.repost and is server-side only: it holds a publish credential.

Copyplugins {
    kotlin("jvm") version "2.1.21"
    id("sh.repost.sdk") version "1.0.18"
}
 
// A Kotlin-only project turns off the Java generator.
repostSdk.generators.named("javaSdk") { enabled.set(false) }
 
dependencies {
    implementation(platform("sh.repost:repost-bom:1.0.18"))
    implementation("sh.repost:repost-client-kotlin")
}

CopypluginManagement {
    repositories { gradlePluginPortal() }
}
 
dependencyResolutionManagement {
    repositories { mavenCentral() }
}

Copyrepost schema init --language kotlin --output ./src/main/kotlin

Copygenerator kotlinSdk {
  language       = "kotlin"
  output         = "../build/generated/sources/repost/kotlinSdk/kotlin"
  resourceOutput = "../build/generated/resources/repost/kotlinSdk"
  packageName    = "com.example.repost"
  clientName     = "RepostClient"
}
 
model Order {
  id String
}
 
type Order {
  created
}
 
event OrderCreated {
  type      @type(Order.created)
  data      Order
  timestamp DateTime
}

Copy./gradlew repostGenerate

Copyrepost auth login
repost schema migrate deploy

Replace the ad-hoc call#

Swap the raw HTTP post for the generated sender. Repost fans the event out to the customer's registered endpoints, so you no longer track webhookUrl yourself. RepostClient is AutoCloseable, so use { } scopes it; the no-arg constructor reads the credential and endpoint from the environment. Build a model inline with the DSL, or pass a prebuilt one:

Copyval result = repost.webhooks.order.created(customerId = "customer-123") {
    id = "order-123"
}
println(result.id)
 
val prebuilt = Order { id = "order-456" }
println(repost.webhooks.order.created("customer-123", prebuilt).id)

A successful send returns a SendResult whose deliveryState is ACCEPTED; any failure throws a RepostException subclass. close() (via use) returns every owned thread and connection to baseline.

Verify delivery#

Trigger the code path that fires the event, then open the dashboard. The send appears in the event stream with its msg_... id and per-endpoint delivery status. Once you trust it, delete the old HTTP call and repeat for the next event type.

Continue#