Documentation

Webhooks

Signed events, retries, dead letters, health and attempt logs.

Events: email.accepted,email.deferred,email.delivered_to_mx,email.bounced,email.complained,email.suppressed,email.inbound,inbox.message.received,domain.degraded,broadcast.winner_selected,email.opened,email.clicked,contact.created,domain.created,autopilot.action.

signature verification
const [ts, sig] = req.headers["transmitly-signature"]
  .split(",").map(v => v.split("=")[1]);
const expected = crypto.createHmac("sha256", secret)
  .update(ts + "." + rawBody).digest("hex");
if (!crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected)))
  return res.status(400).end();
if (Math.abs(Date.now()/1000 - Number(ts)) > 300) return res.status(400).end();

Endpoints can be scoped to one or more sending domains with domain_ids. Omit it, or send an empty array, to receive every domain. Every event payload carries the sendingdomain_id so receivers can route internally too.

Retries use exponential backoff; after 8 attempts the delivery is dead-lettered and visible in the dashboard. Event ids are stable across retries — deduplicate on id. Delivery order is not guaranteed.

Endpoint health tracks the last success, consecutive failed events and 24-hour delivered latency. Every attempt records its HTTP code, duration and last error, and the dashboard filters the log by endpoint, status or event and charts delivered latency over 24 hours, 7 days or 30 days. After ten consecutive dead-lettered events the endpoint is disabled automatically and admins are notified. Queued attempts pause until the endpoint is re-enabled, and re-enabling resets the failure count. Set a per-endpoint slow-alert threshold in milliseconds to notify admins when a delivered request exceeds it. Use POST /v1/webhooks/{id}/status with {"status":"active"} to resume it.

Need the full API surface? OpenAPI 3.1.