---
name: "hiring_design_careers"
area: "hiring"
title: "Design the job pages"
price: "$0.001"
method: "POST"
url: "https://api.conecto.chat/v1/tools/hiring_design_careers"
mcp_server: "https://api.conecto.chat/mcp/hiring"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/hiring/hiring_design_careers"
---

# Design the job pages (`hiring_design_careers`)

Gives the careers and job pages the business's own look: colours, a font, corners, a cover, a headline and its own CSS.

The look of the careers page and every job page with its application form, on top of the brand kit (account_set_brand: name, logo, colour): accent (buttons, links, chosen answers), background and text colours, font (conecto, system, serif or rounded), radius for corners (0 to 24 px), a cover image above the roles (cover_file_id from the file store; "" takes it away), the careers page headline, and css: your own stylesheet. The CSS is confined to the pages: every rule applies inside them, @import and the like are removed and listed in warnings, and "Hiring by Conecto" at the foot stays as it is. Only what you pass changes; "" clears one, reset: true clears them all.

Price: $0.001 a call. A call that fails costs nothing.

## Use it when

The pages should match the business's website, or the owner wants a cover photo of the team.

- For the logo, name and colour every page and email wears, use [account_set_brand](https://conecto.chat/tools/account/account_set_brand.md).

## Say this to your agent

> Make our job pages look like our site: dark green buttons, a warm off-white page, serif type and the workshop photo at the top.

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `accent` | string | no | A hex colour like #0f5132; "" for the default. Up to 7 characters. |  |  |
| `background` | string | no | A hex colour like #0f5132; "" for the default. Up to 7 characters. |  |  |
| `text` | string | no | A hex colour like #0f5132; "" for the default. Up to 7 characters. |  |  |
| `font` | string | no |  | `""`, `"conecto"`, `"system"`, `"serif"`, `"rounded"` |  |
| `radius` | integer or null | no | Pixels; null for the default. 0 to 24. |  |  |
| `cover_file_id` | string | no | A PNG, JPEG, WebP or GIF from the file store, kept as a JPEG of at most 2400 by 1200 pixels. Up to 36 characters. |  |  |
| `headline` | string | no | Default "Careers at <name>". Up to 120 characters. |  |  |
| `css` | string | no | Rules for the pages' own classes (.jb-hero, .jb-role, .jb-job and the form's .fm-*); body and :root mean the page itself. Up to 200,000 characters. |  |  |
| `reset` | boolean | no |  |  |  |

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `hiring_design_careers` on the MCP server `https://api.conecto.chat/mcp/hiring` with these arguments:

```json
{
  "accent": "#0f5132",
  "background": "#faf7f2",
  "font": "serif",
  "radius": 6,
  "headline": "Build bikes with us"
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/hiring_design_careers \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"accent": "#0f5132", "background": "#faf7f2", "font": "serif", "radius": 6, "headline": "Build bikes with us"}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "hiring_design_careers",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.001",
  "balance_usd": "$19.75",
  "result": {
    "design": {
      "accent": "#0f5132",
      "on_accent": "#ffffff",
      "background": "#faf7f2",
      "text": null,
      "font": "serif",
      "radius": 6,
      "cover": null,
      "headline": "Build bikes with us",
      "css": null
    },
    "warnings": [],
    "page_url": "https://cncto.co/j/halverson-cycle-repair"
  }
}
```

`result`: design: every setting (null when not set) and the CSS as the pages use it; warnings: what the CSS checker removed and why, and text that is hard to read on its background; page_url.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `invalid_input` | 400 | A colour is not a hex colour, the font is not on the list, the radius is out of range, the headline is too long, or the cover is not an image. | Fix what the message names. |
| `not_found` | 404 | No file with that cover_file_id in the store. | Upload it with files_upload first. |
| `not_set_up` | 404 | The account has no careers page yet. | Run hiring_setup_careers first. |

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [hiring_setup_careers](https://conecto.chat/tools/hiring/hiring_setup_careers.md): Sets up the careers page at cncto.co/j/<name>: its name, intro, website, reply-to address and who hears about applications. $0.001 a call.
- [hiring_create_job](https://conecto.chat/tools/hiring/hiring_create_job.md): Posts a job with its own page and application form on the careers page. $0.01 a call.
- [hiring_update_job](https://conecto.chat/tools/hiring/hiring_update_job.md): Changes a job's details, its criteria and filter, or opens or closes it. $0.01 a call.
- [hiring_list_jobs](https://conecto.chat/tools/hiring/hiring_list_jobs.md): The business's jobs with their status, page and applicants per stage. Free up to 1,000,000 reads a month.
- [hiring_list_applicants](https://conecto.chat/tools/hiring/hiring_list_applicants.md): Applicants, newest or best match first: for one job or all, by stage, screening, risk, name or email, or the ones kept as spam. Free up to 1,000,000 reads a month.
- [hiring_get_applicant](https://conecto.chat/tools/hiring/hiring_get_applicant.md): One application in full: answers, résumé link, screening and match score, the checks on who sent it, notes and history. Free up to 1,000,000 reads a month.
- [hiring_screen_queue](https://conecto.chat/tools/hiring/hiring_screen_queue.md): The next applications nobody has screened, with the job's criteria and the résumé as text, blind by default. Free up to 1,000,000 reads a month.
- [hiring_record_screening](https://conecto.chat/tools/hiring/hiring_record_screening.md): Saves a review of one application: strong, partial or weak, a summary, and each criterion with its evidence. $0.01 a call.
- [hiring_mark_spam](https://conecto.chat/tools/hiring/hiring_mark_spam.md): Moves one application to spam or back, and can block the network and email domain it came from. $0.001 a call.
- [hiring_get_blocklist](https://conecto.chat/tools/hiring/hiring_get_blocklist.md): The networks and email domains whose applications are kept as spam. Free up to 1,000,000 reads a month.
- [hiring_update_blocklist](https://conecto.chat/tools/hiring/hiring_update_blocklist.md): Blocks or unblocks networks and email domains; what comes from them is kept as spam, with no fee and no emails. $0.001 a call.
- [hiring_move_applicant](https://conecto.chat/tools/hiring/hiring_move_applicant.md): Moves an applicant to another stage of their job, with a note; the candidate is not told. $0.01 a call.
- [hiring_hire_applicant](https://conecto.chat/tools/hiring/hiring_hire_applicant.md): Hires an applicant in one call: Hired in hiring, a person in HR with their résumé on file, and their onboarding checklist started. $0.25 a call.
- [hiring_note](https://conecto.chat/tools/hiring/hiring_note.md): Adds a note to an applicant, rates them 1 to 5, or both. $0.01 a call.
- [hiring_email_applicant](https://conecto.chat/tools/hiring/hiring_email_applicant.md): Emails an applicant in the business's name; replies go to the careers page's reply-to address. $0.02 a call.
- [hiring_invite_to_interview](https://conecto.chat/tools/hiring/hiring_invite_to_interview.md): Emails an applicant a link to book an interview on one of the calendar's meeting types, and can move them to a stage. $0.05 a call.
- [hiring_save_assessment](https://conecto.chat/tools/hiring/hiring_save_assessment.md): Writes a skills test or changes one: questions scored on their own, written answers to mark, a time limit and shuffling. $0.01 a call.
- [hiring_list_assessments](https://conecto.chat/tools/hiring/hiring_list_assessments.md): The business's skills tests: title, questions, time limit, and how many were sent and completed. Free up to 1,000,000 reads a month.
- [hiring_send_assessment](https://conecto.chat/tools/hiring/hiring_send_assessment.md): Emails an applicant their own link to a skills test. $0.02 a call.
- [hiring_assessment_results](https://conecto.chat/tools/hiring/hiring_assessment_results.md): An applicant's tests: status, score, each answer against the expected one, answers to mark, time taken and how often they left the page. Free up to 1,000,000 reads a month.
- [hiring_mark_assessment](https://conecto.chat/tools/hiring/hiring_mark_assessment.md): Gives points to the written answers of a completed test. $0.01 a call.
- [hiring_delete_assessment](https://conecto.chat/tools/hiring/hiring_delete_assessment.md): Deletes a skills test with every candidate's answers to it. Free.
- [hiring_delete_applicant](https://conecto.chat/tools/hiring/hiring_delete_applicant.md): Deletes an applicant and their résumé for good. Free.
- [hiring_dashboard_link](https://conecto.chat/tools/hiring/hiring_dashboard_link.md): A one-time link to hiring at a glance: each applicant's stage and next step, the tests and interviews waiting, and the open jobs. Free up to 1,000,000 reads a month.