---
title: "Mail an invitation: the server makes the user and sends them a link that signs them in"
method: POST
path: "/instances/{instance_id}/auth/users/actions/invite"
tags: ["engines"]
---

# Mail an invitation: the server makes the user and sends them a link that signs them in

`POST /instances/{instance_id}/auth/users/actions/invite`

## Request

- Base URL: `https://app.lathe.live/api/v1`
- URL: `https://app.lathe.live/api/v1/instances/{instance_id}/auth/users/actions/invite`
- Auth: none declared

## Path parameters

- `instance_id` string, required

## Request body

- AuthInviteIn
  - `email` string, required: The address to mail an invitation to. The engine needs an SMTP server set.

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/lathe/apis/lathe-customer-api.md) · [All operations](https://skmtc.dev/lathe/apis/lathe-customer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lathe/apis/lathe-customer-api/revisions/68cfd9bb71c1?raw)