Webhooks Overview

Webhooks let your server react to events in Ttoolab — experiment lifecycle changes, conversions, survey responses, and more.

What are webhooks?

A webhook is an HTTP POST request that Ttoolab sends to a URL you configure. Each request contains a JSON payload describing what happened.

When to use webhooks

Use webhooks when you need to:

• Sync experiment status to an internal admin tool
• Trigger downstream workflows on conversions
• Store CES survey responses in your data warehouse
• Alert your team when a usage limit is reached
• Integrate Ttoolab with Slack, email, or custom automation

For browser-side analytics, use Google Analytics or Clarity instead.

Configure a webhook

1. Open your project in the Ttoolab dashboard.
2. Go to Webhooks and click Create webhook.
3. Enter a name and destination URL (e.g. https://example.com/webhooks/ttoolab).
4. Select which event types to receive.
5. Save the webhook.

Ttoolab generates a webhook secret used to verify request signatures. Copy and store it securely — it is shown once at creation.

Test a webhook

Use the Send test action in the dashboard. Ttoolab sends a webhook.test event to your URL so you can verify your handler works.

Test payload structure:

{
  "id": "EVENT_ID",
  "type": "webhook.test",
  "projectId": "PROJECT_ID",
  "tenantId": "TENANT_ID",
  "createdAt": "2025-06-09T12:00:00.000Z",
  "data": {
    "message": "This is a test event from Ttoolab",
    "test": true
  }
}

Handle failures

• Return 2xx status codes to acknowledge delivery.
• Verify signatures on every request — see Security.
• Implement idempotency using X-Ttoolab-Event-Id — see Events.
• Review Retries for delivery behavior on failure.

Auto-pause

If a webhook endpoint fails repeatedly, Ttoolab automatically disables it after 10 consecutive failures. Re-enable it in the dashboard after fixing your endpoint.

Next steps

• Webhook events
• Webhook security
• Retries