Webhooks connector - Debug common errors

This document contains some common errors that you may come across when using this connector along with some explanation and ways to resolve the issues.

Commons error in webhooks wizard

Webhook address is already used

Webhook address is already used

This issue appears when you have another recipe with the same webhook address. The recipe ID is provided for your reference.

Why does this happen?

The event name will become part of the unique webhook address generated. To avoid recipes receiving webhook events from multiple sources, the event name must be unique across all your webhook recipes.

How do I fix this?

To address this issue, you just need to use a different event name.

Error generating schema for response

Error generating schema

This issue appears when there is a mismatch between the detected Content-Type (from the webhook header) and the payload data type. In the image above, the webhook wizard detected that the webhook contains JSON data from the header. However, it encountered an error when trying to parse the XML payload, <id>1</id>.

Why does this happen?

This happens with legacy or custom applications that may not follow standard HTTP practices, specifically a Content-Type that does not match the payload format.

How do I fix this?

Check with the owner of the application to ensure that the webhooks API is sending the right format and make adjustments if needed. Often, this is not possible. In that case, click Save and skip > and configure the payload schema manually.

My webhook events are receiving 400 bad request

This issue appears when there is a mismatch in the expected payload type or the character encoding of the payload.

Why does this happen?

• Workato performs validations on JSON based webhooks - denoted by your defined Webhook type, to ensure that the payload is valid JSON. Otherwise, Workato responds with 400 bad request.
• Workato performs validations on JSON/Form/XML based webhooks - denoted by your defined Webhook type, to ensure that the payload is UTF-8 compatible. Otherwise, Workato responds with 400 bad request. If your payload is UTF-8 incompatible, use the Raw Binary Data option for Webhook Type

How do I fix this?

Check your incoming webhook payloads to ensure that your webhook payloads match your defined Webhook type. For JSON/Form/XML webhook, inspect the payload to ensure the characters are UTF-8 compatible.