Webhooks

Test & monitor

Send test events and check the status of your deliveries
Available onProEnterprise

Once you have at least one endpoint configured, you can send a test event and watch delivery status directly from Develop > Events.

Send a test event

The Sample payload card shows the exact JSON that will be delivered, with Copy and Send test event buttons.

  • Send test event POSTs the sample payload to every configured endpoint and reports how many succeeded (for example, “Delivered to 2 of 2 endpoints”).
  • Test-event deliveries are sent with the header User-Agent: Ziptax-Webhooks/test and use a 10-second timeout per endpoint.
  • You need at least one configured endpoint to send a test event.

Test events are signed with the same X-Signature header as real deliveries, so you can exercise your signature verification end to end with the Send test event button.

Troubleshoot a failed test

If a test delivery fails, the product surfaces the reason so you can self-diagnose. Common failure reasons:

What you seeLikely cause
Endpoint did not accept the POST / non-2xx responseYour handler returned an error or non-2xx status. Return 2xx to acknowledge.
Host could not be resolvedThe URL’s domain does not resolve. Check for typos.
Connection refused / reset / timed outNothing is listening, or the response took too long. Confirm the service is running and responds within the timeout.
TLS certificate errorThe HTTPS certificate is invalid, expired, or untrusted.

Delivery status & monitoring

The Events page shows a status overview for your account:

  • Status: Delivering or Paused.
    • Paused when there are no endpoints configured (or the last one was removed), or when every event is toggled off across all endpoints.
    • Delivering otherwise.
  • Last delivery: the time of the most recent delivery across your account’s endpoints (relative, e.g. “6h ago”).
  • Last response code: the HTTP status returned by that most recent delivery (2xx = success).

Only the single most recent delivery is surfaced. There is no full delivery history or log feed in the product today. If you need a durable record of every delivery, log deliveries in your own handler as you receive them.

Next step

Best practices

Patterns for reliable, secure webhook handling.