---
title: "Create invitation token for a new user."
method: POST
path: "/api/invitations"
tags: ["Users"]
---

# Create invitation token for a new user.

`POST /api/invitations`

## Request body

- object
  - `scope` 'admin' | 'install' | 'update' | 'read'

## Response `201`

Data of the newly created invitation token.

- InvitationResponse
  - `id` string, required
  - `token` string, required
  - `scope` 'admin' | 'install' | 'update' | 'read', required — Permission scope of the token.
  - `grant_type` 'invitation' — Grant type of the token
  - `expires` integer — Timestamp when the one-time token expires.
  - `url` string — Registration URL to create a new user account.

---

[API](https://skmtc.net/contao/apis/contao-manager-api.md) · [All operations](https://skmtc.net/contao/apis/contao-manager-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/contao/contao-manager-api/versions/074d8046de13/schema)