Skip to main content
POST
/
v1
/
workforce
/
plans
Create a workforce plan
curl --request POST \
  --url https://api.plane.com/v1/workforce/plans \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "starts": "<string>",
  "ends": "<string>",
  "currency": "<string>",
  "frequency": "<string>",
  "metadata": {}
}
'
{
  "name": "FY27 hiring plan",
  "starts": "2026-07-01",
  "ends": "2027-06-30",
  "currency": "USD"
}

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.

​
Parameters

Workforce plans are created as drafts. Use the approval flow when a plan is ready to lock.
​
name
string
required
Human-readable plan name.
​
starts
string
required
Start date for the planning window.
​
ends
string
required
End date for the planning window.
​
currency
string
Three-letter ISO currency code for calculation rollups. Defaults to the workspace currency.
​
frequency
string
Planning frequency. Currently monthly.
​
metadata
object
Set of key-value pairs attached to the plan.

​
Returns

Returns the created Workforce plan object. 
{
  "name": "FY27 hiring plan",
  "starts": "2026-07-01",
  "ends": "2027-06-30",
  "currency": "USD"
}