---
title: "create a service account"
method: POST
path: "/w/{workspace}/workspaces/create_service_account"
tags: ["workspace"]
---

# create a service account

`POST /w/{workspace}/workspaces/create_service_account`

## Path parameters

- `workspace` string, required

## Request body

- object
  - `username` string, required
  - `is_admin` boolean — Grant the service account workspace admin. Defaults to false. Cannot be combined with operator=true.
  - `operator` boolean — Make the service account an operator. Defaults to true for backward compatibility. Set to false to count as a developer (1 seat) instead of 0.5 seat.
  - `add_to_deployers` boolean — Add the service account to the workspace `wm_deployers` group on creation. Recommended when the account will be used as a CLI sync / CI deploy identity so it can deploy on behalf of other users.

## Response `201`

service account created

---

[API](https://skmtc.dev/windmill/apis/windmill-api.md) · [All operations](https://skmtc.dev/windmill/apis/windmill-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/windmill/windmill-api/revisions/7b281701c340/schema)