> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a position

> Create a planned, open, or filled workforce seat.

Use positions as the rows inside a workforce plan. Employee positions include
payroll-backed employment costs; contractor positions include contractor pay.

### Parameters

<ParamField body="name" type="string">
  Optional display name for the planned seat.
</ParamField>

<ParamField body="plan" type="string">
  Workforce plan ID.
</ParamField>

<ParamField body="location" type="object" required>
  Position location.
</ParamField>

<ParamField body="employer" type="object" required>
  Employer model for the position. Supported types are `employee` and
  `contractor`.
</ParamField>

<ParamField body="starts" type="string" required>
  Position start date.
</ParamField>

<ParamField body="ends" type="string">
  Position end date.
</ParamField>

<ParamField body="compensation" type="object" required>
  Compensation input for the position.
</ParamField>

### Returns

Returns the created [Position object](/reference/positions/object).

<ResponseExample>
  ```json Request theme={null}
  {
    "name": "Canada employee hire",
    "plan": "wfp_R8mK2pQ9xL4s",
    "location": { "country": "CA", "subdivision": "ON" },
    "employer": { "type": "employee" },
    "starts": "2026-09-01",
    "compensation": {
      "amount": "120000.00",
      "currency": "CAD",
      "unit": "year",
      "basis": "regular",
      "frequency": "monthly",
      "source": { "type": "manual" }
    }
  }
  ```

  ```json Response theme={null}
  {
    "id": "pos_kP9r2NqW6mT4",
    "object": "position",
    "name": "Canada employee hire",
    "status": "draft",
    "plan": "wfp_R8mK2pQ9xL4s",
    "job": null,
    "worker": null,
    "location": { "country": "CA", "subdivision": "ON" },
    "employer": { "type": "employee" },
    "starts": "2026-09-01",
    "ends": null,
    "compensation": {
      "amount": "120000.00",
      "currency": "CAD",
      "unit": "year",
      "basis": "regular",
      "frequency": "monthly",
      "source": { "type": "manual" }
    },
    "manager": null,
    "department": null,
    "metadata": {},
    "created": "2026-05-27T12:00:00Z",
    "updated": "2026-05-27T12:00:00Z"
  }
  ```
</ResponseExample>