Webhook notifications are available on higher plans or as a paid add-on.
Step 1: Add the notification
- Go to Dashboard → Notifications and click Add notification.
- Pick Webhook.
Step 2: Configure your webhook
- Paste your endpoint into URL.
- If your endpoint needs auth, pick Basic auth or Bearer token under Authentication.
- Pick the filters that should send jobs.
- Click Add notification.
Technical Specifications
- HTTP Method: POST
- Content-Type: application/json
- Timeout: 10 seconds
- Batching: one request carries every new job of one alert, in the
projectsarray
Testing your webhook
Click Send test in the setup form. Vollna sends up to 3 recent jobs from the picked filters, in the same format as a live alert.Payload example
After you’ve set up your webhook, you will start receiving notifications when new job opportunities match your selected filters.Field reference
Top-level fields:
Fields of each item in
projects[]:
Fields of
client_details:
Best practices
- Respond quickly (aim < 5 seconds) and do processing asynchronously.
- Return 2xx for successful deliveries.
- Validate fields defensively: projects and client fields may vary by site and job type.
Troubleshooting
Webhook not receiving requests
- Ensure your URL is publicly reachable and responds with HTTP 2xx.
- Verify auth settings (token/credentials).
- Use Send test request to validate connectivity.
- Check server/firewall logs for blocked requests.