Create job
Jobs
POST create job
Endpoint
POST /api/v1/jobs
Parameters
| Name | Description |
|---|---|
| job[title] required | Job title |
| job[drivers_required] required | Job drivers required |
| job[industries] required | Job industries |
| job[start_date] required | Job start date |
| job[end_date] | Job end date |
| job[ongoing] | Job ongoing |
| job[postcode] required | Job postcode |
| job[description] required | Job description |
| job[licenses] | Job licenses |
| job[min_rating] required | Job min rating |
| job[young_drivers] | Job young drivers |
| job[inexperienced_drivers] | Job inexperienced drivers |
| job[job_type] required | Job job type |
| job[show_by] required | Job show by |
| job[expected_weekly_hours] | Job expected weekly hours |
| job[hours_from] | Job hours from |
| job[hours_to] | Job hours to |
| job[wages_attributes] required | Job wages attributes |
| job[overtime_after] | Job overtime after |
| job[overtime_rate] | Job overtime rate |
| job[dbs_check] | Job dbs check |
| job[dbs_last_performed_months] | Job dbs last performed months |
Request
Route
POST /api/v1/jobs
Headers
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMzMyIiwic2NwIjoidXNlciIsImF1ZCI6bnVsbCwiaWF0IjoxNzYzNjI2Mzk0LCJleHAiOjE3NjYyMTgzOTQsImp0aSI6ImFjNjVhZmIxLWNiYTctNDEzYy1hNWQwLTg5Mzk0MTQzYWFkZSJ9.-avmgUrzAJDLDso6gbMuBMfo551nnKRmFB9Vg-1yyU0
Host: example.org
Cookie:
Body
{
"job": {
"show_by": "minimum_hours",
"expected_weekly_hours": 19,
"currency": "GBP",
"title": "Forward Liaison",
"description": "Addo depromo optio. Magnam clibanus sed.",
"postcode": "M1 1AE",
"industries": [
"courier",
"private_hire"
],
"drivers_required": 7,
"start_date": "2025-11-25",
"end_date": "2026-03-03",
"min_rating": 2.7,
"licenses": [
"phv",
"hiab"
],
"job_type": "part_time",
"status": "published",
"published_at": "2025-11-20T07:13:14.917Z",
"wages_attributes": {
"0": {
"kind": "sunday",
"rate": 100
}
}
}
}
Response
Simulated Response
Status
200
Headers
x-frame-options: SAMEORIGIN
x-xss-protection: 0
x-content-type-options: nosniff
x-permitted-cross-domain-policies: none
referrer-policy: strict-origin-when-cross-origin
content-type: application/json; charset=utf-8
vary: Accept, Origin
etag: W/"34cfda95bb149d69bb5c88a207c9467f"
cache-control: max-age=0, private, must-revalidate
x-request-id: 3cf6e3c4-ea86-4bc0-9e9b-7637e192140d
x-runtime: 0.017958
content-length: 665
Body
{
"job": {
"id": 475,
"chat": null,
"currency": "GBP",
"dbs_check": "no",
"dbs_last_performed_months": null,
"description": "Addo depromo optio. Magnam clibanus sed.",
"drivers_required": 7,
"end_date": "2026-03-03",
"expected_weekly_hours": 19,
"hours_from": null,
"hours_to": null,
"industries": [
"courier",
"private_hire"
],
"inexperienced_drivers": false,
"job_type": "part_time",
"licenses": [
"phv",
"hiab"
],
"min_rating": "2.7",
"number": 82927009,
"overtime_rate": null,
"postcode": "M1 1AE",
"published_at": null,
"show_by": "minimum_hours",
"start_date": "2025-11-25",
"status": "draft",
"title": "Forward Liaison",
"wages": [
{
"id": 800,
"driver_rate": null,
"kind": "sunday",
"rate": "100.0"
}
],
"young_drivers": false
}
}