---
title: "Invite a User to a Hub"
method: POST
path: "/v1/hub/{hub_id}/invite"
tags: ["Hub"]
---

# Invite a User to a Hub

`POST /v1/hub/{hub_id}/invite`

Invite a single user to join a hub by email. If the user already exists, they are added directly; otherwise, an invite is sent. Requires owner or admin permissions.

## Path parameters

- `hub_id` string, uuid, required

## Request body

- CreateInvite
  - `email` string, email, required
  - `tags` string[]
  - `projectRole` 'member' | 'admin' | 'owner'

## Response `201`

User invited or added successfully

- object
  - `metadata` object
  - `data` string

## Other responses

- `400` — Error in sending invite email or user already invited
- `403` — Not authorized to invite users to this hub
- `404` — Hub not found
- `405` — Hub is not active

---

[API](https://skmtc.net/morta-technology/apis/morta-api-reference.md) · [All operations](https://skmtc.net/morta-technology/apis/morta-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/morta-technology/morta-api-reference/versions/9c58c1c1e7e8/schema)