Job Post

Post a new job to carehome.co.uk. Each job uses one job credit and stays live for 30 days.

Who can use it: Enhanced and Platinum subscribers with at least one job credit. Partners post with the subscriber's API key and their own partner_key.

Post a job

POST /index.cfm/jobs

Base URL https://api.carehome.co.uk. Authentication, errors and support are covered in the Jobs API overview.

Send the fields as a JSON object with the header Content-Type: application/json. IDs can be sent as numbers or strings.

Body parameters

Salary

Give the pay in one of these ways:

job_salary_from must not be higher than job_salary_to, and both need a job_pay_type_id.

Branding

A job is shown on carehome.co.uk as posted by a setting or group. That is its branding, and you set it with job_member_id.

job_member_id is optional. If you leave it out, the job is branded as the setting or group your API key belongs to. We recommend always sending it: it links the job to the right setting, which helps it reach the right candidates and gets better application rates.

• Your own setting: send your own ID.
• Another setting in your group: send that setting's ID. A group can brand jobs as any of its settings.

Get the IDs you can use from /jobs/members. Any other ID fails with valid job_member_id is required.

Job description

We clean up job_description before it is shown:

• Use simple HTML: p, br, b, strong, i, em, u, ul, ol and li. Attributes are removed, and other tags may be removed.
• Sentences containing contact details are removed: email addresses, web addresses, and phone numbers.
• Empty paragraphs and repeated spaces are removed.

Applicants apply through carehome.co.uk, using job_contact_email or job_contact_url, so contact details aren't needed in the description.

Duplicate references

If you send "uniqueReference": true with a job_reference, we check your open jobs, and those of your group, for the same reference. If there is one, the job is not posted and no credit is used. The response is 409:

{
  "data": {},
  "error": [],
  "warn": [
    "There is an existing job with the reference EXAMPLE-001"
  ]
}

Example request

curl -X POST "https://api.carehome.co.uk/index.cfm/jobs" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY",
    "job_title": "Care Assistant (example)",
    "job_category_id": 5,
    "job_setting_id": 10,
    "job_type_id": 1,
    "job_description": "<p>An example job description.</p>",
    "job_skills": "Example skill, another example skill",
    "job_contact_name": "Example Name",
    "job_contact_email": "example@example.com",
    "job_admin_email": "example@example.com",
    "job_processed_by": "Example Name",
    "job_pay_type_id": 2,
    "job_salary_from": "12.50",
    "job_salary_to": "13.50",
    "job_town_id": 12345,
    "job_reference": "EXAMPLE-001"
  }'

Example response

201 Created. data is the new job, in the same format as the job list. Keep job_id: you need it to edit or close the job.

{
  "data": {
    "job_id": 96000000001,
    "job_title": "Care Assistant (example)",
    "job_posted_date": "2026-10-01 09:30:00",
    "job_expiry_date": "31-Oct-2026 00:00:00",
    "job_link": "https://www.carehome.co.uk/jobs/job.cfm/id/96000000001",
    "...": "other job fields"
  },
  "error": [],
  "warn": []
}

Errors

Validation errors return 400 with the reasons in error. Common messages: