Test Your Webhook Endpoint
Use the Test button in your webhook settings to confirm your endpoint is reachable and handling payloads correctly before you rely on live events.
This guide shows you where to find the test button, what the test request includes, and how to resolve common errors.
Send a Test Webhook
In Rivo admin, go to Settings > Webhooks.
Find the webhook you want to validate.
Click Test in that webhook row.
In the Send Test Webhook modal, confirm the Webhook URL.
Optional: replace the URL in the modal if you want to test a different endpoint.
Click Send Test Webhook.
You’ll be returned to the Webhooks page with a success or error message.
Tip: URL changes made in the test modal are for that test send only. Your saved webhook URL does not change unless you edit and save the webhook itself.
What the Test Request Includes
A test send uses the event type configured on that webhook and sends sample data for that event.
Each test payload includes:
event_type(the webhook event you selected)test: trueoccurred_at(timestamp)data(sample event data)
Rivo signs the request using your webhook’s Secret Token and includes the signature in the request headers.
How Success and Failures Are Determined
A test webhook is marked successful when your endpoint returns a 2xx response.
You’ll see an error if:
The endpoint URL is invalid
The endpoint returns a non-
2xxresponse (for example,404or500)The endpoint times out or can’t be reached
When a failure happens, Rivo shows a message on the Webhooks page so you can troubleshoot quickly.
URL Requirements for Test Sends
To protect your store, test sends only allow valid public http or https URLs.
Test sends are blocked for URLs like:
localhost127.0.0.1Private or local network addresses
Invalid or non-resolving hosts
If a URL is blocked, you’ll see an Invalid URL error.
Troubleshooting Checklist
If your test webhook fails:
Confirm the endpoint URL is public and starts with
https://.Confirm your endpoint responds within a few seconds.
Check that your endpoint returns a
2xxstatus code.Verify your signature validation uses the webhook’s current Secret Token.
Retry with the Test button after making changes.
For full webhook reference docs and event details, see Rivo Webhooks.
FAQ
Does sending a test webhook trigger customer actions?
No. Test sends are for endpoint validation and include sample data with a test flag.
Can I test a different endpoint without changing my saved webhook?
Yes. You can override the URL in the test modal for a one-time test send.
Where do I find the signing secret?
Open the webhook in Settings > Webhooks and copy the Secret Token shown in the webhook settings.