Webhooks must be enabled for your environment before you can configure endpoints and receive events. While they’re disabled, you can still read event and delivery history, but you can’t change configuration, send tests or replay.
Set up an endpoint
1
Create an endpoint
Open Webhooks in the developer dashboard. Enter a public HTTPS URL on port 443 and choose the event types you need. URLs with query parameters, credentials, IP addresses, private destinations or redirects are rejected. You can have up to five endpoints per application and environment.
2
Save the signing secret
The secret is shown once, right after creation. Store it in your server’s secret manager. Each endpoint has its own secret; your legacy account webhook secret isn’t used.
3
Verify your destination
Click Verify destination. Prava sends a signed
webhook.endpoint_verification request. Verify the signature against the raw request body, then return a 2xx JSON response containing the exact challenge value you received. This is a control message, not an event you subscribe to.4
Test and activate
Send a signed test event and confirm your receiver accepts it. Test events have
test: true and synthetic IDs. Activate delivery once your receiver is ready. Changing the URL later pauses delivery until you verify again.Roles
Dashboard access is limited to the selected application and environment.
Multi-app setups
If you manage several applications from one workspace, you can configure webhooks for each ready application from there. Webhook management needs credential generation enabled for your workspace. Your existing workspace access, environment and roles apply, and each application doesn’t need to approve it separately. To open one application’s webhooks, select Webhooks in your workspace, find the application and choose Manage webhooks. The application’s Integration view also links there.Use one receiver for several applications
1
Create the endpoints
On Webhooks, select up to ten applications on the current page, enter the receiver URL and choose events. Prava creates a separate, paused endpoint for each application.
2
Save each signing secret
Each secret is labelled with its application. Save every one before you leave the page.
3
Verify and activate each endpoint
Open Verify and configure for each result to verify, test and activate delivery.