Skip to content
Helix
PricingDocsChangelog
Log inStart free
Documentation
Overview
Getting Started with HelixYour First Mission WalkthroughFocus Mode vs Console ModeDesktop & Mobile Companion Apps
5-Minute API QuickstartIntegrations & Autonomous ChannelsProduction Examples & Recipes
Helix Agent Overview & Autonomy TiersHelix AdvisorHelix OperatorHelix PhasesHelix Sandbox
Synthetic AI & Simulation WorkflowsDrop-In White-Label Agent EmbedsDeveloper & Embed Guide
Helix ArchitectureArchitecture & Technical GuideHybrid Compute Bridge & Custom MCPHelix MCP
MCP Providers & Cloud Connectors
REST, Gateway & MCP API ReferenceAuthentication, Keys & ScopesSDKs & Programmatic ClientsWebhooks, HMAC Verification & ReplayTroubleshooting & Error Playbook
Helix Security ArchitectureEnterprise Security, Secrets & GovernanceBilling, Compute Windows & Quotas
Developer PlatformDeveloper Console
Docs/API, SDKs & Webhooks/Webhooks, HMAC Verification & Replay

Webhooks, HMAC Verification & Replay

Build reactive workflows in Slack bots, CI pipelines, billing engines, or SaaS notifications whenever Helix completes work or reaches a human approval gate.

Supported Event Types

Event NameTrigger Condition
run.startedAutonomous sandbox provisioned and execution loop started
run.completedMission reached completed or verified terminal state
run.failedExecution aborted or exhausted retries with diagnostic summary
approval.requestedT2 / T3 gate paused execution waiting on human review
approval.decidedReviewer clicked Approve, Rework, or Reject
ledger.recordedEd25519 signed action receipt appended to workspace hash chain

Step 1 — Register an HTTPS Endpoint

Configure endpoints visually under Developer Console -> Webhooks or programmatically:

BASH
curl -X POST https://launchverse.app/api/webhooks/platform \
  -H "Authorization: Bearer hx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "targetUrl": "https://api.example.com/webhooks/helix",
    "events": ["run.completed", "approval.requested", "ledger.recorded"]
  }'

SSRF guardrails reject plain HTTP, localhost, loopback (127.0.0.1), link-local (169.254.*), and private RFC1918 CIDRs on public webhooks. For private internal listeners, route via Helix Bridge.

Step 2 — Verify HMAC-SHA256 Signatures (Always!)

Every delivery signs the exact raw UTF-8 request body using your webhook subscription secret (X-Helix-Signature header):

TypeScript / Node.js

TS
import { createHmac, timingSafeEqual } from "node:crypto";

export function verifyHelixWebhook(rawBody: string, headerSig: string, secret: string): boolean {
  const expected = createHmac("sha256", secret).update(rawBody, "utf8").digest("hex");
  const cleanSig = headerSig.replace(/^sha256=/, "").trim();
  const a = Buffer.from(expected, "utf8");
  const b = Buffer.from(cleanSig, "utf8");
  return a.length === b.length && timingSafeEqual(a, b);
}

Python (FastAPI / Flask)

PYTHON
import hmac
import hashlib

def verify_helix_webhook(raw_body: bytes, header_sig: str, secret: str) -> bool:
    expected = hmac.new(secret.encode("utf-8"), raw_body, hashlib.sha256).hexdigest()
    clean_sig = header_sig.removeprefix("sha256=").strip()
    return hmac.compare_digest(expected, clean_sig)

Step 3 — Delivery Guarantees & Replay

  • Respond with HTTP 2xx within 10 seconds to acknowledge delivery; persist heavy jobs asynchronously.
  • Deduplicate handlers using the unique deliveryId in each payload envelope.
  • Transient failures retry automatically with exponential backoff (30s -> 2m -> 10m -> 1h).
  • Replay failed deliveries interactively in Developer Console -> Webhooks or via API:
BASH
curl -X POST https://launchverse.app/api/webhooks/platform \
  -H "Authorization: Bearer hx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"action": "replay"}'
PreviousSDKs & Programmatic ClientsNext Troubleshooting & Error Playbook
Edit this page on GitHub↗

Platform

How Helix worksSpecialist crewScreens & architectureSecurity & isolationSystem status

Products

Helix WorkspaceAI Staff & Role PacksEmbedded B2B2C StaffPricing & plans

Developers

Developer PlatformDeveloper ConsoleAPI ReferenceSDKs & CLIWebhooks & events

Resources

DocumentationQuickstart guideChangelogHelp Center

Solutions

Use casesCode migrationCVE remediationMulti-cloud ops

Company

About LaunchVerseCareersContact ussupport@launchverse.app

Legal

Privacy PolicyTerms of ServiceExternal status

Social

Sovereign agentic infrastructure engineered in Africa for global engineering teams.

Helix

AI Specialists & Assistants for Everyday Work.

© 2026 LaunchVerse (Helix). All rights reserved.Privacy·Terms·Security·Status