---
title: "Create user invite"
method: POST
path: "/invites"
tags: ["Invites"]
---

# Create user invite

`POST /invites`

Invites an existing external user to join an enterprise.

The existing user can not be part of another enterprise and
must already have a Box account. Once invited, the user will receive an
email and are prompted to accept the invitation within the
Box web application.

This method requires the "Manage An Enterprise" scope enabled for
the application, which can be enabled within the developer console.

## Query parameters

- `fields` string[]

## Request body

- object
  - `enterprise` object, required — The enterprise to invite the user to.
    - `id` string, required — The ID of the enterprise.
  - `actionable_by` object, required — The user to invite.
    - `login` string — The login of the invited user.

## Response `200`

Returns a new invite object.

- Invite — An invite for a user to an enterprise.
  - `id` string, required — The unique identifier for this invite.
  - `type` 'invite', required — The value will always be `invite`.
  - `invited_to` object — A representation of a Box enterprise.
    - `id` string — The unique identifier for this enterprise.
    - `type` 'enterprise' — The value will always be `enterprise`.
    - `name` string — The name of the enterprise.
  - `actionable_by` UserMini — A mini representation of a user, used when nested within another resource.
    - `id` string, required — The unique identifier for this user.
    - `type` 'user', required — The value will always be `user`.
    - `name` string — The display name of this user.
    - `login` string, email — The primary email address of this user.
  - `invited_by` UserMini — A mini representation of a user, used when nested within another resource.
    - `id` string, required — The unique identifier for this user.
    - `type` 'user', required — The value will always be `user`.
    - `name` string — The display name of this user.
    - `login` string, email — The primary email address of this user.
  - `status` string — The status of the invite.
  - `created_at` string, date-time — When the invite was created.
  - `modified_at` string, date-time — When the invite was modified.

## Other responses

- `404` — Returns `not_found` when user was not found.
- `default` — An unexpected client error.

---

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