conecto. Get started
Hiring

Design the job pages

hiring_design_careers · Changes data · Markdown

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

$0.001 a call

From your agent’s balance. A call that fails costs nothing.

An example

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.

Your agent callshiring_design_careers$0.001 a call

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{
  "accent": "#0f5132",
  "background": "#faf7f2",
  "font": "serif",
  "radius": 6,
  "headline": "Build bikes with us"
}
What comes back
{
  "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"
}

Use it when

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

What it does

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.

What comes back

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. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
accentstringA hex colour like #0f5132; "" for the default. Up to 7 characters.
backgroundstringA hex colour like #0f5132; "" for the default. Up to 7 characters.
textstringA hex colour like #0f5132; "" for the default. Up to 7 characters.
fontstringOne of: ,conecto,system,serif,rounded.
radiusinteger or nullPixels; null for the default. 0 to 24.
cover_file_idstringA PNG, JPEG, WebP or GIF from the file store, kept as a JPEG of at most 2400 by 1200 pixels. Up to 36 characters.
headlinestringDefault "Careers at <name>". Up to 120 characters.
cssstringRules 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.
resetboolean

The call

Over MCP, call hiring_design_careers on https://api.conecto.chat/mcp/hiring. Over REST:

Terminal
curl -X POST 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"}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
invalid_input400A 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_found404No file with that cover_file_id in the store.Upload it with files_upload first.
not_set_up404The account has no careers page yet.Run hiring_setup_careers first.

More Hiring tools

All 25 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md