The TypeScript SDK.
Install @round-robin-solutions/hopwire on your server. It generates idempotency keys, retries safely and raises errors you can switch on.
What you get
Types from the API spec
Request and response types are generated from the OpenAPI specification.
Idempotent by default
Every create call carries an Idempotency-Key. Pass your own or let the SDK generate one.
Careful retries
Network errors, 429 and 5xx responses are retried up to twice, waiting for Retry-After when given.
Typed errors
HopwireError carries the stable code, message and request ID.
Webhook verifier
verifyWebhook checks Standard Webhooks signatures and accepts two secrets during a rotation.
More languages
At launchFurther SDK languages.
Questions
Which runtime does it need?
Node 26 or later, on the server.
Can I use it in a browser or mobile app?
No. An API key must never reach a browser or a mobile app.
Does cancelling my request cancel the send?
No. Once accepted, the message continues. Use the cancel endpoint for scheduled messages.
Related
- APIAvailableA versioned JSON API at api.hopwire.io for messages, templates, tenants, senders, webhooks and usage, with idempotency and cursor pagination.
- WebhooksAvailableStandard Webhooks signatures, at-least-once delivery, event IDs to deduplicate on, secret rotation and replay.
- Error codesAvailableStable request error codes and delivery outcome codes, each with a cause, a fix, and whether it retries or falls back.
Start with the beta.
Hopwire is free during the invite-only beta. Tell us what you send and we will reply by email.