Webhooks
In brief
Webhooks are configured in the authenticated developer area (Starter+). Signed JSON payload, automatic retry.
Setup
Go to https://app.askmarcel.app/developers, Webhooks tab. Add your server HTTPS URL. A signing secret is provided to verify authenticity.
Tier required
Webhooks are available from Starter tier (production allowed).
Events
- diagnostic.completed — sourced diagnostic completed successfully
- quota.warning — envelope threshold reached (80%)
- quota.exceeded — envelope exhausted
Payload format
diagnostic.completed example
{
"event": "diagnostic.completed",
"timestamp": "2026-08-09T12:00:00Z",
"data": {
"brand": "Mitsubishi",
"error_code": "E7",
"confidence": "high",
"chunk_id": "chk_abc123"
}
}Security
- X-AM-Signature header: HMAC-SHA256 of body with your secret
- Verify signature before processing the event
- Respond 2xx within 10s — otherwise exponential retry (3 attempts)