---
title: "Invite User"
method: POST
path: "/v1/workspace/invites/add"
tags: ["workspace"]
---

# Invite User

`POST /v1/workspace/invites/add`

Sends an email invitation to join your workspace to the provided email. If the user doesn't have an account they will be prompted to create one. If the user accepts this invite they will be added as a user to your workspace and your subscription using one of your seats. This endpoint may only be called by workspace members with the WORKSPACE_MEMBERS_INVITE permission. If the user is already in the workspace a 400 error will be returned.

## 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

- BodyInviteUserV1WorkspaceInvitesAddPost
  - `email` string, required — The email of the customer
  - `workspace_permission` string, nullable — The workspace permission of the user. This is deprecated, use `seat_type` instead.
  - `seat_type` 'workspace_admin' | 'workspace_member' | 'workspace_lite_member' — Seat types for workspace members.
  - `group_ids` string[], nullable — The group ids of the user
  - `usage_limit` integer, nullable — Monthly credit usage limit for the invitee. Omit or set to null for no custom cap.

## Response `200`

Successful Response

- AddWorkspaceInviteResponseModel
  - `status` string, required — The status of the workspace invite request. If the request was successful, the status will be 'ok'. Otherwise an error message with status 500 will be returned.

## 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/3b2cee2701a3/schema)