---
title: "Create Workspace Invitation"
method: POST
path: "/api/workspaces/{workspace_id}/invitations"
---

# Create Workspace Invitation

`POST /api/workspaces/{workspace_id}/invitations`

## Path parameters

- `workspace_id` string, required

## Request body

- InvitationSendRequest
  - `email` string, email, required
  - `name` string, nullable
  - `role` 'workspace_admin' | 'workspace_member'

## Response `200`

Successful Response

- InvitationSendResponse
  - `message` string, required
  - `details` object, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-06** `4cbf44e1d4fd` — 1 info
  - added the new optional request property `role`

[Change history](https://skmtc.dev/outcallerai/apis/fastapi/changes/api/workspaces/:workspace_id/invitations/post.md)

---

[API](https://skmtc.dev/outcallerai/apis/fastapi.md) · [All operations](https://skmtc.dev/outcallerai/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/outcallerai/fastapi/revisions/2a1adc380310/schema)
