Set up the careers page

hiring_setup_careers · Changes data · Markdown

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

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

Set up a careers page: we sell and fix bikes in Portland. Replies go to jobs@, and tell Luis about every application.

Your agent callshiring_setup_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

{
  "name": "Halverson Cycle & Repair",
  "intro": "We sell, build and fix bikes in our workshop on SE Ash St in Portland: seven of us, and more in summer.",
  "website": "https://halversoncycle.example",
  "reply_to": "jobs@halverson-cycle-repair.useconecto.com",
  "notify_email": "luis@halversoncycle.example"
}

What comes back

{
  "careers": {
    "name": "Halverson Cycle & Repair",
    "page_url": "https://cncto.co/j/halverson-cycle-repair",
    "intro": "We sell, build and fix bikes in our workshop on SE Ash St in Portland: seven of us, and more in summer.",
    "website": "https://halversoncycle.example",
    "reply_to": "jobs@halverson-cycle-repair.useconecto.com",
    "notify_email": "luis@halversoncycle.example",
    "ai_review": false,
    "ai_notice": null,
    "application_limit": null,
    "open_jobs": 0
  }
}

Use it when

Before the first job, or when the page's words or addresses change.

What it does

The careers page at cncto.co/j/<name> that lists the open jobs: its name, a short intro, the website, the address candidates' replies go to, and who hears about each application. Only what you pass changes.

What comes back

careers: the page's name, address, intro, website, reply-to, notification address and ai_review. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`name`	string	1 to 120 characters.
`intro`	string	Up to 2,000 characters.
`website`	string	Up to 500 characters.
`reply_to`	string	Up to 254 characters.
`notify_email`	string	Up to 254 characters.
`ai_review`	boolean	Tell candidates on every application form that AI may help review applications, as the EU's AI Act asks. Required before screening with hiring_screen_queue.
`ai_notice`	string	Your own words for that notice; "" for ours (a person decides, and how to ask a person to look again). Up to 600 characters.
`application_limit`	object or null	At most count applications from one person in days, across every role, like {"count": 2, "days": 180}; the form says so. null: no limit.
`application_limit.count`Required	integer	1 to 50.
`application_limit.days`Required	integer	1 to 730.

The call

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

Terminal

curl -X POST https://api.conecto.chat/v1/tools/hiring_setup_careers \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Halverson Cycle & Repair","intro":"We sell, build and fix bikes in our workshop on SE Ash St in Portland: seven of us, and more in summer.","website":"https://halversoncycle.example","reply_to":"jobs@halverson-cycle-repair.useconecto.com","notify_email":"luis@halversoncycle.example"}'

When it refuses

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

Code	When	What to do
`invalid_input`400	An address is not an email address, or website is not an https:// link.	Fix the field the message names.
`payment_required_for_outbound`402	notify_email is outside the business and the balance is still free credit.	Use the owner's address, or top up once (POST /v1/topups).

More Hiring tools

All 25 tools

Give this to your agent.

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

Set up the careers page

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Hiring tools

Give this to your agent.