Webhooks - JobKit API

You can define the webhook URL in your job board settings page. When a new job is published, a POST HTTP request will be made to that URL, carrying a JSON payload that looks like this:

{
  "title": "Job title",
  "description": "Job description in Markdown format",
  "location": "Worldwide",
  "arrangement": "remote",
  "salary": "100000",
  "salary_currency": "USD",
  "salary_period": "yearly",
  "company": "Company LLC",
  "company_website": "https://www.company.com",
  "application_type": "email",
  "application_email": "email@company.com",
  "created_at": "2026-01-10T16:16:11.126Z",
  "published_at": "2026-01-10T16:16:11.127Z",
  "expires_at": "2026-03-09T16:12:07.347Z",
  "term": {
    "id": 1,
    "name": "Full-time"
  },
  "category": {
    "id": 1,
    "name": "Engineering"
  },
  "plan": {
    "name": "Basic",
    "price": 0,
    "period": 30,
    "highlight": false,
    "badge": false,
    "pin": false
  },
  "user": {
    "email": "user@company.com",
    "created_at": "2026-01-10T12:16:11.126Z",
    "role": "user",
    "jobs_count": 5
  },
  "url": "https://job.board.com/jobs/1.json",
  "preview_image_url": "https://job.board.com/jobs/1.png",
  "logo": "https://job.board.com/files/.../1.png",
}

The receiving URL should return an appropriate HTTP response code, e.g.

200 for success
4xx for client errors
5xx for server errors

Webhook requests will be retried up to 5 times until successfully received.

Make sure your webhook URL is secure, so you don’t leak user data!

Example use cases

Post a notification on Slack, Discord and/or other communities
Post a social media post on LinkedIn, X, Facebook, etc.
Analyze/transform the published data and send an email notification
Trigger an AI agent workflow

Automation tools

There are many tools you can use to receive the webhook and trigger different workflows. Here are just a few for your reference:

Users

​Example use cases

​Automation tools

Example use cases

Automation tools