---
title: "Invite member"
method: POST
path: "/workspaces/invitations"
tags: ["Workspace Invitations"]
---

# Invite member

`POST /workspaces/invitations`

## Request

- Base URL: `https://app.freyavoice.ai/api/v2`
- URL: `https://app.freyavoice.ai/api/v2/workspaces/invitations`
- Auth: HTTP bearer

Sends an email invitation to join the workspace. The invitee can accept within 7 days.

## Request body

- object
  - `workspaceId` string, uuid, required: Workspace ID
  - `email` string, email, required: Email address to invite
  - `role` 'member' | 'admin': Role to assign: member or admin
  - `message` string: Optional invitation message

## Response `200`

Invitation sent

- object
  - `success` true, required
  - `data` object, required
    - `message` string, required
    - `result` object, required
      - `invitation` object, required
        - `id` string, required
        - `workspaceId` string, required
        - `inviterId` string, required
        - `email` string, email, required
        - `role` string, required
        - `status` string, required
        - `token` string, required
        - `expiresAt` string, required
        - `createdAt` string, required
        - `updatedAt` string, required
        - `acceptedAt` string, nullable
        - `inviterEmail` string, nullable
        - `inviterDisplayName` string, nullable
      - `emailWarning` string

## Other responses

- `400`: Validation error
- `401`: Missing or invalid token
- `409`: User already a member or has pending invitation
- `500`: Server error

---

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