# Invite users to an account (tenant) in bulk

Invite users to an account (tenant) in bulk.

Provide an array of users in the request body. Each entry must include a user's email.

Endpoint: POST /resources/users/bulk/v1/invite
Security: bearer

## Header parameters:

  - `frontegg-tenant-id` (string, required)
    The account (tenant) ID identifier

## Request fields (application/json):

  - `users` (array, required)

  - `users.email` (string)

  - `users.username` (string)
    The username of the user. If not provided, the email is required. Maximum length is 255 characters.

  - `users.name` (string)

  - `users.profilePictureUrl` (string)

  - `users.password` (string)

  - `users.phoneNumber` (string)

  - `users.provider` (string)
    Enum: "local", "saml", "google", "github", "facebook", "microsoft", "scim2", "slack", "apple"

  - `users.metadata` (string)
    Stringified JSON object
    Example: "{}"

  - `users.skipInviteEmail` (boolean)

  - `users.roleIds` (array)

  - `users.emailMetadata` (object)

  - `users.expirationInSeconds` (number)
    Temporary user expiration in seconds

  - `users.verified` (boolean)