Integrations, API and feeds
If you post jobs from an applicant tracking system, a multiposter or your own site, you should not have to retype them here. Everything below is free, included with any advert package, and takes about ten minutes to wire up.
Post jobs in
A JSON endpoint with an API key. Create, update and close adverts from your own system. Re-sending the same advert updates it rather than duplicating it.
Get applications out
Every application is emailed to the address on your advert, shown in your dashboard, pushed to your webhook and available to poll. Use whichever suits your system.
Take our feed
Every live advert in one XML or JSON file, in the shape aggregators expect. Public, no key needed.
Posting a job
Get your key from the integrations page in your dashboard. Treat it like a password.
POST https://hiringuk.co.uk/api/v1/jobs
curl -X POST https://hiringuk.co.uk/api/v1/jobs \
-H "X-API-Key: huk_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"title": "HGV Class 1 Driver",
"location": "Birmingham",
"region": "West Midlands",
"sector": "Logistics, Transport & Warehousing",
"job_type": "Permanent",
"salary": "£17.20 per hour, overtime at £25.80",
"description": "Trunking and store deliveries on a four on four off rota...",
"apply_email": "jobs@yourcompany.co.uk",
"reference": "YOUR-ATS-REF-123"
}'
What happens. If your account has advert credits or an unlimited plan, the advert goes live immediately. If not, we create it and return an order with a payment link, and it goes live the moment that is paid. Send the same reference again and we update the existing advert instead of creating a second one, which is what multiposters need.
| Field | Required | Notes |
|---|---|---|
| title | yes | The job title people search for, not your internal grade |
| location | yes | A town or city. "Remote" is fine |
| description | yes | At least 60 characters. Plain text or simple HTML |
| region, sector, job_type | no | Must match our published lists, returned in the error if they do not |
| salary, apply_email, company, reference | no | Salary is read for the salary filter, so put a real figure in |
Other endpoints: GET /api/v1/jobs lists yours, DELETE /api/v1/jobs/{id} closes one, GET /api/v1/applications?since=2026-08-01 pulls applications.
Receiving applications
Webhook
Give us an HTTPS URL and we POST each application as JSON the moment it arrives, with a link to the CV. Every request carries an X-HiringUK-Signature header: an HMAC SHA256 of the body, keyed with your API key, so you can prove it came from us.
{
"event": "application.received",
"job": { "id": 142, "reference": "HUK-00142",
"your_reference": "YOUR-ATS-REF-123" },
"application": {
"id": 908, "name": "Jane Smith",
"email": "jane@example.co.uk", "phone": "07700 900123",
"cv_url": "https://hiringuk.co.uk/employers/applications/908/cv"
}
}
Email, dashboard or polling
No webhook? Applications are emailed to the address on the advert with the CV attached, they sit in your dashboard, and GET /api/v1/applications lets your system poll for anything new. You do not have to choose: all four run at once.
CV downloads are authenticated: your API key or your dashboard session. Candidate data is yours to use for that vacancy under the terms of business.
Our public job feed
Every live advert, refreshed as adverts go up and come down. Example adverts are excluded, so the feed only ever contains real vacancies.
- https://hiringuk.co.uk/feeds/jobs.xml in the standard job publisher XML format, which the major aggregators and job search engines all read.
- https://hiringuk.co.uk/feeds/jobs.json for anything that would rather not parse XML.
- https://hiringuk.co.uk/sitemap.xml lists every advert and location page, and each advert carries JobPosting structured data for Google for Jobs.
Aggregators and partners are welcome to take the feed. If you need a variation, a different field or a scheduled drop, ask.
Using a multiposter?
If your ATS or distribution tool needs us as a destination, put us in touch with them and we will do the technical work at our end. It costs you nothing, and it costs them nothing.