Create a workspace

POST

workspaces

curl https://api.plane.com/v1/workspaces \
  -u YOUR_PARTNER_API_KEY: \
  -d name="Acme Inc"

{
  "id": "wsp_8rT2mVq5xNp3Kd",
  "name": "Acme Inc",
  "status": "active",
  "customer": "cus_6wJm3RkQp9xT2v",
  "created": "2026-08-04T16:20:00Z",
  "updated": "2026-08-04T16:20:00Z"
}

Requires an API key of a partner workspace. The created workspace bills to your partner customer, and your keys can act inside it by passing its ID in the Plane-Workspace header on other endpoints.

Parameters

string

required

The name of the workspace, usually the client company’s name.

Returns

Returns the created Workspace object.

curl https://api.plane.com/v1/workspaces \
  -u YOUR_PARTNER_API_KEY: \
  -d name="Acme Inc"

{
  "id": "wsp_8rT2mVq5xNp3Kd",
  "name": "Acme Inc",
  "status": "active",
  "customer": "cus_6wJm3RkQp9xT2v",
  "created": "2026-08-04T16:20:00Z",
  "updated": "2026-08-04T16:20:00Z"
}

⌘I

curl https://api.plane.com/v1/workspaces \
  -u YOUR_PARTNER_API_KEY: \
  -d name="Acme Inc"

{
  "id": "wsp_8rT2mVq5xNp3Kd",
  "name": "Acme Inc",
  "status": "active",
  "customer": "cus_6wJm3RkQp9xT2v",
  "created": "2026-08-04T16:20:00Z",
  "updated": "2026-08-04T16:20:00Z"
}

Working with the API

Core Resources

HR

Workforce

Benefits

Payments

Payroll

Documents

Time

Labor

Legal

Parameters

Returns