---
id: create-position
name: Create Position
description: Create a position by answering a few questions in the chat.
pages:
  - positions
status: active
prompt: Create a position
triggers:
  - create a position
  - create position
  # A client is the company a position is staffed for, so asking for one starts
  # the same conversation — it simply leads with the company question.
  - create a client
  - create client
  - add a client
  - new client
  - create a * position
  - create * position
  - new position
  - new * position
  - post a job
  - post a * job
  - open a role
  - open a * role
  - add a position
  - i want to hire
actions:
  - create_position
---

# Create Position

## Purpose

Create a position without leaving the Positions page. Owliver asks for what it
does not already know, one question at a time, offers the answers as chips, then
reads the whole thing back before anything is written.

No form opens. No page is navigated to. The record created is the same
`JobPosting` the manual form writes, through the same create action.

## Capabilities

- Understand requests to create positions.
- Read the role, location, pay, experience, English level and certifications out
  of a single sentence.
- Ask only for what the request did not already answer.
- Offer each answer as a suggestion, so the whole flow can be clicked.
- Read the position back for confirmation before creating it.
- Create the position on the page you are already on.

## Conversation

Each line is `field | question | suggestions | required?`. Suggestions beginning
with `@` come from the application's own data, so a role category added in the
form is offered here without this file changing.

`@companies` is the clients this organization already staffs for, read off the
postings already on screen. Picking one is a tap; typing a name that is not on
the list is how a new client is named, which is all "create a client" has ever
meant here — the company is a field on the position, not a record of its own.

- company | Which client is this role for? | @companies | required
- role_category | What role are you hiring for? | @roles | required
- location | Where will this role be based? | Chennai; Bengaluru; Coimbatore; Bay Area; Other | required
- pay | What is the pay range? | $18–$28/hr; $25–$35/hr; $30–$40/hr; Custom | required
- min_experience_years | Any minimum experience? | No minimum; 1 year; 2 years; 3+ years | optional
- english_required | What is the minimum English level? | @english | optional
- certifications_required | Any required certifications? | @certifications; None | optional

## Actions

- create_position