---
title: "Create Service Account"
method: POST
path: "/v1/service-accounts"
tags: ["workspace"]
---

# Create Service Account

`POST /v1/service-accounts`

Create a new service account in the workspace. By default, a workspace can have up to 20 service accounts. Enterprise customers may request an increase to this limit, up to 100.

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Request body

- BodyCreateServiceAccountV1ServiceAccountsPost
  - `name` string, required
  - `default_sharing_groups` DefaultSharingGroupConfig[], nullable — List of groups with their permission levels to share with by default. Each entry should specify a group_id and a permission_level (admin, editor, or viewer).
    - `group_id` string, required — The ID of the group to share with
    - `permission_level` 'admin' | 'editor' | 'viewer', required — The permission level to grant to the group

## Response `200`

Successful Response

- WorkspaceCreateServiceAccountResponseModel
  - `service-account-user-id` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/revisions/b96b80bcbb83/schema)