Job Booking Status Update

Sent when the status of a job booking changes. Whenever a job booking is booked, published, or otherwise updated, Kini POSTs a payload to the URL you configure.

Overview

Sent when the status of a job booking changes — for example when it is booked, published, or expires. Use it to keep your system in sync with the lifecycle of each booking.

Payload

The following payload is sent to your configured webhook URL:

{
  "company_id": 123,
  "company_name": "Test GmbH",
  "partner_company_id": "1019261",
  "booking_job_id": 98234,
  "booking_id": 954237,
  "booking_job_title": "Koch (w/m/d)",
  "booking_product_name": "Indeed.com Germany (Sponsored Job)",
  "booking_url": "https://www.indeed.com/koch/",
  "booking_status": "PUBLISHED",
  "transaction_id": "ffdc0e8c-2653-4589-96bb-fef46e9fb520"
}

Field Name	Type	Description
`company_id`	int	The unique Kini ID of the company.
`company_name`	string	The name of the company.
`partner_company_id`	string	The partner-specific ID of the company, in case it was provided upon company onboarding.
`booking_job_id`	int	The unique Kini ID of the job for which the job booking was made.
`booking_id`	int	The unique Kini ID of the job booking.
`booking_job_title`	string	The title of the job booking.
`booking_product_name`	string	The name of the product which was purchased for this job booking.
`booking_url`	string	The URL of the job booking once it is published. For new bookings, this field is empty until the booking is published.
`booking_status`	enum	The current status of the job booking (`BOOKED`, `PROCESSING`, `PUBLISHED`, `PUBLISH_FAILED`, `UNPUBLISHED`, `EXPIRED`).
`transaction_id`	uuid	The unique transaction ID associated with the job booking.

Status Values

The booking_status field can have the following values:

BOOKED: The job booking was successfully created in the database.
PROCESSING: The job booking has been reviewed and is queued to be posted online.
PUBLISHED: The job booking is now online on the job board. The booking_url field will be filled.
PUBLISH_FAILED: The job booking could not be published on the job board. Contact tech@getkini.com for details.
UNPUBLISHED: The job booking was prematurely taken down by the customer.
EXPIRED: The duration for which the job booking was online has ended. The booking has been removed from the job board.

Delivery & Retries

Deliveries are sent as an HTTPS POST with a JSON body and a 20-second timeout. If your endpoint returns a retryable status (429, 500, 502, 503, 504) or the connection times out, Kini retries up to 3 times with exponential backoff (roughly 1s, 2s, then 4s). Any other non-2xx response is treated as a permanent failure and is not retried.

Authentication

Kini calls your endpoint, so authentication is under your control: when your webhook is set up, you tell us which HTTP headers each delivery should carry — for example an Authorization: Bearer {token} header or a custom API-key header that your endpoint checks. Kini stores these securely and sends them with every request.

Setup

Webhook endpoints are configured per company in the Kini Partner App. Provide the HTTPS URL that should receive events and the headers Kini should send with each delivery. Need help? Contact tech@getkini.com.

Was this page helpful?