Join BoxWorks 2024 to discover what's possible with content and AI!
Register now!Create user invite
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.
Request
Query Parameters
id,type,nameA comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response.
Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.
Request Body
The user to invite
"john@example.com"The login of the invited user
The enterprise to invite the user to
"1232234"The ID of the enterprise
Response
Returns a new invite object.
Returns not_found when user was not found.
An unexpected client error.
Request Example
curl -i -X POST "https://api.box.com/2.0/invites" \
-H "authorization: Bearer <ACCESS_TOKEN>" \
-H "content-type: application/json" \
-d '{
"enterprise": {
"id": "1232234"
},
"actionable_by": {
"login" : "freeuser@box.com"
}
}'await client.invites.createInvite({
enterprise: {
id: currentUser.enterprise!.id!,
} satisfies CreateInviteRequestBodyEnterpriseField,
actionableBy: {
login: email,
} satisfies CreateInviteRequestBodyActionableByField,
} satisfies CreateInviteRequestBody);client.invites.create_invite(
CreateInviteEnterprise(id=current_user.enterprise.id),
CreateInviteActionableBy(login=email),
)await client.Invites.CreateInviteAsync(requestBody: new CreateInviteRequestBody(enterprise: new CreateInviteRequestBodyEnterpriseField(id: NullableUtils.Unwrap(NullableUtils.Unwrap(currentUser.Enterprise).Id)), actionableBy: new CreateInviteRequestBodyActionableByField() { Login = email }));try await client.invites.createInvite(requestBody: CreateInviteRequestBody(enterprise: CreateInviteRequestBodyEnterpriseField(id: currentUser.enterprise!.id!), actionableBy: CreateInviteRequestBodyActionableByField(login: email)))BoxUser user = new BoxUser(api, "0");
user.invite("Enterprise ID", "Invited User Login");enterprise = client.get_current_enterprise()
invitation = enterprise.invite_user('user@example.com')client.enterprise.inviteUser('1345', 'jsmith@box.com', callback);client.users.inviteToJoinEnterprise(
login: "user@example.com",
enterpriseId: "12345"
) { (result: Result<Invite, BoxSDKError>) in
guard case let .success(invite) = result else {
print("Error inviting user to enterprise")
return
}
print("Invited user \(invite.actionableBy.name) to \(invite.invitedTo.name)")
}Response Example
{
"id": "11446498",
"type": "invite",
"actionable_by": {
"id": "11446498",
"type": "user",
"login": "ceo@example.com",
"name": "Aaron Levie"
},
"created_at": "2012-12-12T10:53:43-08:00",
"invited_by": {
"id": "11446498",
"type": "user",
"login": "ceo@example.com",
"name": "Aaron Levie"
},
"invited_to": {
"id": "11446498",
"type": "enterprise",
"name": "Acme Inc."
},
"modified_at": "2012-12-12T10:53:43-08:00",
"status": "pending"
}