Create a webhook: Review & test and the signing secret
Learn how to test a new Empath webhook before saving it, create it, and store its signing secret safely.
Learn how to test your new webhook, create it, and save the signing secret.
Steps
- On Review & test, check the summary: Webhook URL, Custom header, Events and Authentication.
- Click Test webhook. Empath sends a sample request to your address: - Data sent shows the exact body Empath sent. - Data received shows your receiver's answer: the HTTP status and response body (up to 2,048 characters).
- If you see Failed to reach the endpoint, fix the address or receiver and test again.
- Click Create.
- On Webhook created, click Copy next to Signing secret and store it in your secrets manager. Copy this now — you won't be able to see it again.
- Click Done.
[Screenshot: the Review & test step after a successful test]
Good to know
- The wizard's test is signed with a temporary secret. It proves your address is reachable, not that your signature check works. After creating the webhook, use Test webhook on its row: that's signed with the real secret. See “Test deliveries vs live deliveries”.
- The signing secret is 64 hexadecimal characters. It can't be shown again or changed. If you lose it, delete the webhook and create a new one.
- Tests are limited to 10 a minute for your company.
Still need help?
Reach out to your Partner Success Manager, or email us at support@empathmsp.com. We’re happy to help!
Related articles
- Verify the signature
- Test deliveries vs live deliveries
- Edit, test or delete a webhook