Skip to main content
Webhook Notifications allow you to receive real-time job alerts when new projects are published and match your selected filters.
Webhook notifications are available with Agency plan or as paid add-on.

​
Step 1: Open Notifications setup

  1. Go to Dashboard → Notifications.
  2. Locate Webhook in the list of notification providers.
  3. Click Setup.

​
Step 2: Configure your webhook

  1. Enter your Webhook URL.
  2. If needed, configure authentication.
  3. Click Save settings.
Authentication credentials are stored securely and are not shared with any third parties.

​
Technical Specifications

  • HTTP Method: POST
  • Content-Type: application/json
  • Timeout: 10 seconds

​
Testing your webhook

Use Send test request in the setup form to send a sample payload and verify your endpoint is reachable.

​
Payload example

After you’ve set up your webhook, you will start receiving notifications when new job opportunities match your selected filters. 
{
  "total": 19,
  "results_url": "https://www.vollna.com/dashboard/monitoring/result/12345",
  "filter": {
    "id": 123,
    "name": "Backend Development",
    "url": "https://www.vollna.com/dashboard/filter/123"
  },
  "filters": [
    {
      "id": 123,
      "name": "Backend Development",
      "url": "https://www.vollna.com/dashboard/filter/123"
    },
    {
      "id": 124,
      "name": "API Development",
      "url": "https://www.vollna.com/dashboard/filter/124"
    }
  ],
  "projects": [
    {
      "url": "https://www.vollna.com/go?module=webhook&uid=0&tid=0&pid=3359&url=https%253A%2F%2Fwww.upwork.com%2Fjobs%2F%257E01146ebeb34b098d8c",
      "title": "S3 Bucket to Bigcommerce API",
      "description": "I am looking for a developer who can create an API intergration to import products from an Amazon S3 bucket to Bigcommerce...",
      "skills": ["PHP", "API Integration", "Amazon S3", "BigCommerce"],
      "budget_type": "hourly",
      "budget": "15 - 25 USD",
      "site": "Upwork.com",
      "published": "2024-08-24T07:16:32+00:00"
    }
  ]
}

​
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

  1. Ensure your URL is publicly reachable and responds with HTTP 2xx.
  2. Verify auth settings (token/credentials).
  3. Use Send test request to validate connectivity.
  4. Check server/firewall logs for blocked requests.