Expected response (Acknowledgement)
Your webhook endpoint should acknowledge successful receipt by returning an HTTP 2xx status code (recommended: 200 OK).
- 2xx response → Notification is marked as Delivered
- Non-2xx response / request timeout / endpoint unreachable → Notification is marked as Failed and will be retried
No specific response body is required. We only rely on the HTTP status code.
Failure handling
A delivery attempt is considered failed in any of the following cases:
- Non-2xx HTTP response (e.g., 400, 401, 403, 404, 409, 429, 500, etc.)
- Request timeout: no HTTP response is received from your endpoint within 15 seconds
- Connection error (DNS failure, TLS/handshake error, network failure)
- Endpoint temporarily unavailable
Your endpoint should return an HTTP 2xx response within 15 seconds. Responses received after this timeout may still be treated as failed and retried.
We recommend returning an appropriate HTTP status code that reflects whether the issue is temporary or permanent.
Retry policy
When delivery fails, MiniHotel automatically retries the notification using the schedule below:
- Retry after 10 seconds
- Retry after 1 minute
- Retry after 5 minutes
- Retry after 10 minutes
- Retry after 1 hour
- Retry after 6 hours (final attempt)
After the final attempt, the notification remains marked as Failed.