> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goshippo.com/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.goshippo.com/feedback

```json
{
  "path": "/docs/Tracking/WebhookDebugging",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Webhook debugging

> Test and debug your Shippo webhooks using your own server or third-party webhook testing sites.

## Using your own server

If you have a public-facing web server and would like to view the test events as they come in, you can use this BASH one-liner (listening on port 8891). This snippet returns the HTTP 200 response we expect your endpoint to return in production.

<Info>
  **note**

  You do not need to have jq installed as this is just for pretty printing the POST Body response.
</Info>

jq formatting for webhook test listener:

`~$ while true; do { echo -e 'HTTP/1.1 200 OK\r\n'; } | nc -l 8891 | grep test | jq . ; done`

<img src="https://mintcdn.com/shippo-f4b7b609/o3pSHzWv8pMmorWX/images/Tracking/webhooks2.png?fit=max&auto=format&n=o3pSHzWv8pMmorWX&q=85&s=4455c56d4883231913ecc2ff1904bd27" alt="Webhooks Debugging Screenshot" width="638" height="673" data-path="images/Tracking/webhooks2.png" />

## Using webhook testing sites

There are many websites available to test a webhook response. You can use sites like [https://webhook-test.com/](https://webhook-test.com/) to listen for webhooks sent by Shippo.

<Info>
  **note**

  While you can test your webhooks using public services, it's important to understand that you are sharing your information with these third-parties. Only use test data. Never share production data. We recommend using [your own server](#using-your-own-server) where possible.

  The mention of a specific company or product name is solely for educational purposes and does not imply endorsement by Shippo.
</Info>

To use a service like webhook-test, copy the unique webhook URL from the site and add it as the `URL` to your Shippo webhook.

Selecting `Send sample` sends a test payload that you can view in the webhook testing site.

<img src="https://mintcdn.com/shippo-f4b7b609/o3pSHzWv8pMmorWX/images/Tracking/webhook-test.png?fit=max&auto=format&n=o3pSHzWv8pMmorWX&q=85&s=6dd879f2eb39f938b517a7734bf275b4" alt="webhook testing website sample" width="2870" height="1574" data-path="images/Tracking/webhook-test.png" />
