Skip to main content

Overview

Instead of polling for task status, configure a webhook to receive notifications when events occur. ModelHunter.AI will POST a JSON payload to your URL.

Register a Webhook

Event Types

Webhook Payload

Headers

Body

Per-Job Webhooks vs Configured Webhooks

There are two types of webhook delivery:
  • Configured webhooks (registered via POST /api/v1/webhooks) include X-Webhook-Signature for verification and support automatic retries.
  • Per-job webhooks (via webhookUrl in a generation request) do not include X-Webhook-Signature (no shared secret), but include additional headers: X-Webhook-Event (e.g. task.completed) and X-Job-ID.

Signature Verification

Configured webhooks include an X-Webhook-Signature header. Verify it to ensure the request is authentic. The signature is computed as HMAC-SHA256(timestamp + "." + body, secret).

Retry Policy

If your endpoint does not return a 2xx status, ModelHunter.AI retries with exponential backoff: After 3 failed attempts, the delivery is marked as failed. You can replay it from the Dashboard.

Test a Webhook

Send a test event to verify your endpoint:

Manage Webhooks