giodea
09/25/2025, 8:07 AMVercel
09/25/2025, 8:15 AMVercel
09/25/2025, 8:15 AMgiodea
09/25/2025, 9:48 AMgiodea
09/25/2025, 9:49 AMVercel
09/25/2025, 1:37 PMgiodea
09/26/2025, 9:53 AMChiranjeet Mishra
09/26/2025, 10:19 PMtoolCallId in your response matches exactly with the ID from the request. Any mismatch can cause the response to be ignored.
2. **Correct JSON Structure**:
Your webhook should always return a JSON structure with a results array. Here’s a response format template:
json
{
"results": [
{
"toolCallId": "call_123",
"result": "Your response as a single-line string"
}
]
}
Make sure to check for line breaks in responses, which can cause parsing errors. Use single-line strings.
3. **HTTP Status Code**:
Always return HTTP 200, even for errors, with details inside the results array.
4. **Schema Validation**:
If you have schema validation enabled, check your call logs for "Schema validation errors" which indicate missing required parameters or incorrect schema definitions.
5. **Structured Outputs**:
Ensure your structured outputs are configured correctly in your API or dashboard. They should be attached to an assistant and configured to extract and return the correct data structure.
You can review detailed troubleshooting steps and response templates [here](https://docs.vapi.ai/tools/custom-tools-troubleshooting).
Let me know if there's anything else you need help with.