Ramy
10/29/2025, 1:46 PMVapi Support Bot
10/29/2025, 1:48 PMRamy
10/29/2025, 1:50 PMRamy
10/29/2025, 1:51 PMVapi Support Bot
10/29/2025, 1:52 PMcredentialId.
Example:
json
{
"server": {
"url": "https://your-client-api.com/endpoint",
"credentialId": "cred_your_custom_id"
}
}
Make sure the credential includes your header name and value. This will ensure Vapi sends the header with every request.
See: [Server authentication – Using credentials in tools](https://docs.vapi.ai/server-url/server-authentication)
Source:
- [Server authentication](https://docs.vapi.ai/server-url/server-authentication)Ramy
10/29/2025, 2:17 PMVapi Support Bot
10/29/2025, 2:18 PMcredentialId field?
This step is required for Vapi to send any custom header, even if it's not for authentication ([see documentation](https://docs.vapi.ai/server-url/server-authentication)).
Source:
- [Server authentication](https://docs.vapi.ai/server-url/server-authentication)Ramy
10/29/2025, 2:20 PMVapi Support Bot
10/29/2025, 2:22 PMcredentialId field. This is now required for all custom headers, regardless of their purpose.
Example:
json
{
"server": {
"url": "https://your-client-api.com/endpoint",
"credentialId": "cred_your_custom_id"
}
}
Be sure to define the header in the credential itself. This step is necessary even if it worked differently in your own account before.
[See documentation](https://docs.vapi.ai/server-url/server-authentication)
Source:
- [Server authentication](https://docs.vapi.ai/server-url/server-authentication)Adrian
10/29/2025, 3:06 PMRamy
10/29/2025, 3:09 PMChiranjeet Mishra
10/29/2025, 7:55 PMresults array and must use single-line strings. Always return an HTTP 200 status [details can be found here](https://docs.vapi.ai/tools/custom-tools-troubleshooting).
3. Parameter Verification: Ensure all required parameters are included and strictly validated in your tool schema. Add strict: true to catch validation errors early [read more here](https://docs.vapi.ai/tools/custom-tools-troubleshooting).
4. **ToolCallId**: Ensure the toolCallId in your response exactly matches the one in the request to avoid mismatch errors.
5. Token Limits: If your responses are getting cut off, increase the maxTokens parameter for complex tools up to 500 [further guidance here](https://docs.vapi.ai/tools/custom-tools-troubleshooting).
Following the above steps should help diagnose common issues with your API tools. If specific error logs are available, they might provide additional insights.