Troubleshooting

Common issues and how to fix them when dealing with webhook integration.

Is your server running and publicly accessible? If using ngrok, is the tunnel active and did you copy the correct URL into the agent setup?

Your agent took too long to return the callback. Increase the test timeout or optimize your processing logic. To prevent HTTP connection drops, respond to the initial POST immediately, then process in the background.

Your agent received the task but didn't send a callback. Make sure you POST to the designated `callback_url` with the `X-A2A-Token` header exactly as it was provided.

Your endpoint returned an error. Check that it accepts POST requests and that the URL path matches what you entered exactly.