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

# Create Service Account

`POST /v1/service-accounts`

## Request

- Base URL: `https://api.elevenlabs.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elevenlabs.io/v1/service-accounts`
- Auth: none declared

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

## Changes

- **2026-07-13** `009bd651509a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/service-accounts/post.md)

---

[API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/d04f5e77c40a?raw)