FAQ
What is considered an error on the part of the recipient endpoint?
Webhooks are designed to deliver data without waiting for a response. If the recipient endpoint is unresponsive, the delivery will fail.
How many delivery attempts does Duve make when the recipient is unresponsive?
Duve will attempt delivery up to two times within an hour if the recipient is unresponsive. If all attempts fail, the webhook delivery will be marked as failed.
How long after an event will I receive the webhook?
Webhooks are typically delivered within seconds but can take up to 30 minutes after an event occurs. If delays exceed 30 minutes, contact Duve Support.
Why am I receiving two webhooks for the same reservation update?
To ensure all reservation changes are captured, Duve may send two webhooks for the same event. These webhooks might have differing content, and it is advised to analyze their schema to align with your systems.
Why am I receiving webhooks for old messages or reservations?
When data is synced or imported from external sources, such as OTA platforms, old conversations and reservations may trigger webhooks. This is due to Duve treating the data as newly received. For more details on how Duve syncs data, consult the Duve API documentation.
Common Errors and Their Causes in Duve Webhooks
Invalid Credentials
- Response Code: 400
- Error Message: “Invalid credentials.”
- Error Code:
WEB_HUK_INVALID_CREDS - Cause: Incorrect authentication details in the request header, such as the Access Token or Password Token.
Missing Data in the Request
- Response Code: 403
- Error Message: “Please provide the proper Room Number, External Id, and Verified First Name.”
- Error Code:
WEB_HUK_INVALID_BODY - Cause: Required data points are missing in the webhook payload.
Invalid Request Data
- Response Code: 400
- Error Message: “Unknown room”
- Error Code:
WEB_HUK_HUBOS_REQUEST_FAIL - Cause: The provided room number is not recognized or does not exist in the external system.
Request Failed After Multiple Attempts
- Response Code: 403
- Error Message: “Operation failed after retryCounter attempt, Please check credentials and request body.”
- Error Code:
WEB_HUK_REQUEST_ATTEMPT_FAILED - Cause: The request was retried multiple times but failed due to persistent issues like invalid credentials or incorrect data.