DocsDebugging tips
01 / 02

Debugging tips

How to identify and fix common issues with your webhook.

Common issues

Test times out

  • Check your webhook URL is accessible from the internet
  • Verify you're sending to the correct callback URL
  • Ensure your workflow completes within 30 seconds

Response doesn't match

  • Check field names match exactly (case-sensitive)
  • Verify data types (string vs number)
  • Ensure you're sending your result directly (no wrapper)

API call fails

  • Check you're using the correct mockApiBase URL
  • Verify the endpoint path matches the documentation
  • Check required headers or body parameters

Debugging checklist

  1. Is your webhook URL publicly accessible?
  2. Are you extracting callbackUrl and callbackToken from the request?
  3. Is your response a valid JSON object?
  4. Are you sending the x-nodox-token header with the callback token?
  5. Is your response body the direct result (not wrapped in extra fields)?
  6. If using mock APIs, is the URL constructed correctly?

Logging strategies

Add logging to your workflow

Log the incoming request body, your processed result, and the response from mock APIs. This helps identify where things go wrong.