---
title: "Invite User"
method: POST
path: "/v1/users/invite"
tags: ["Users"]
---

# Invite User

`POST /v1/users/invite`

## Request

- Base URL: `https://api.oviond.com`
- URL: `https://api.oviond.com/v1/users/invite`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Invite a new user to the account.

## Request body

- InviteUserRequest
  - `email` string, email, required
  - `fullname` string, required
  - `role` 'admin' | 'clients' | 'readonly', required
  - `clients` string[]
  - `avatar_url` string: Optional starting avatar URL or path (e.g. a Media URL); defaults to a placeholder the user can replace.

## Response `201`

User invited

- InviteUserResponse
  - `success` true, required
  - `data` object, required
    - `email` string, required

## Other responses

- `409`: User already exists

---

[API](https://skmtc.dev/oviond/apis/oviond-backend-api.md) · [All operations](https://skmtc.dev/oviond/apis/oviond-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/oviond/apis/oviond-backend-api/revisions/4cb0a07daf41?raw)