---
title: "Create and Invite User"
method: POST
path: "/users/invite"
tags: ["users"]
---

# Create and Invite User

`POST /users/invite`

Creates and invites a new user to your account.

## Headers

- `Authorization` string, required
- `X-Disable-Hooks` 'true', required

## Request body

- TypeUsersUserCreateAndInviteRequest — Properties used to create a new user
  - `email` string, required
  - `name` string, required
  - `actorRoles` TypeRolesAssignActorRoleRequest[], required
    - `roleId` string, required — Role ID
    - `resourceId` union, required
      - string — Account ID
      - string — Environment ID
      - string — Space ID

## Response `200`

Response with status 200

- TypeUsersUserWithRolesResponse
  - `data` TypeUsersUserWithRoles, required
    - `email` string, required
    - `name` string, required
    - `accountId` string, required — Account ID
    - `id` string, required — User ID
    - `idp` string, required
    - `idpRef` string
    - `metadata` object, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `lastSeenAt` string, date-time
    - `dashboard` integer
    - `actorRoles` TypeRolesActorRoleResponse[], required
      - `id` string, required — Actor Role ID
      - `roleId` string, required — Role ID
      - `actorId` union, required
        - string — User ID
        - string — Agent ID
        - string — Guest ID
      - `resourceId` union, required
        - string — Account ID
        - string — Environment ID
        - string — Space ID
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required

---

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