Skip to main content
POST
Register a URL to receive POST requests whenever events happen on your job board. Supports generic webhooks, Discord, and Slack.

Request Body

string
required
The event to subscribe to. Use * to receive all events.Available events:
  • job.created — a new job is posted
  • job.updated — a job is edited
  • job.approved — a job is approved / set to active
  • job.expired — a job expires
  • job.deleted — a job is deleted
  • job.status_changed — any status transition
  • application.received — a new application is submitted
  • application.status_changed — an application status changes
  • user.created — a new job board user is created
  • subscription.created — a subscription starts
  • subscription.canceled — a subscription ends
  • payment.received — a payment succeeds
  • * — all events
string
required
The type of endpoint: webhook, discord, or slack.
string
required
The URL that will receive POST requests.
string
An HMAC signing secret (min 16 characters). When provided, every delivery includes an X-Kardow-Signature header so you can verify authenticity. Only used for webhook target type.

Webhook Payload

Every delivery sends a JSON body like this:
On generic webhooks, every job.* event includes data.job: the full job in the same shape as Get Job, read when the event is delivered. The example shows the main fields. You can use it to post the job to another platform without calling the API. data.job is left out if the job can no longer be read. On generic webhooks, user.created includes where the new user came from, so you can pass it to a newsletter or CRM:
The fields are the same as on the user object. Discord and Slack targets automatically format the payload into embeds / blocks.

Signature Verification

If you provided a secret, verify deliveries like this:

Examples

Subscribe to all job events via webhook

cURL

Subscribe a Discord channel

cURL

Response

object

Authorizations

x-api-key
string
header
required

API key for authentication. Get yours from Settings > API Keys in the Kardow dashboard.

Body

application/json
event
enum<string>
required
Available options:
job.created,
job.updated,
job.approved,
job.expired,
job.deleted,
job.status_changed,
application.received,
application.status_changed,
user.created,
subscription.created,
subscription.canceled,
payment.received,
*
target_type
enum<string>
required
Available options:
webhook,
discord,
slack
target_url
string<uri>
required
secret
string
Minimum string length: 16

Response

Existing subscription returned

data
object
required