gitlab-org--gitlab-foss/doc/api/invitations.md

stage	group	info
Growth	Expansion	To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#designated-technical-writers

Invitations API

Use the Invitations API to send email to users you want to join a group or project.

Valid access levels

To send an invitation, you must have access to the project or group you are sending email for. Valid access levels are defined in the Gitlab::Access module. Currently, these levels are valid:

• No access (0)
• Guest (10)
• Reporter (20)
• Developer (30)
• Maintainer (40)
• Owner (50) - Only valid to set for groups

CAUTION: Caution: Due to an issue, projects in personal namespaces will not show owner (50) permission.

Invite by email to group or project

Invites a new user by email to join a group or project.

POST /groups/:id/invitations
POST /projects/:id/invitations

Attribute	Type	Required	Description
id	integer/string	yes	The ID or URL-encoded path of the project or group owned by the authenticated user
email	integer/string	yes	The email of the new member or multiple emails separated by commas
access_level	integer	yes	A valid access level
expires_at	string	no	A date string in the format YEAR-MONTH-DAY

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" --data "email=test@example.com&access_level=30" "https://gitlab.example.com/api/v4/groups/:id/invitations"
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" --data "email=test@example.com&access_level=30" "https://gitlab.example.com/api/v4/projects/:id/invitations"

Example responses:

When all emails were successfully sent:

{  "status":  "success"  }

When there was any error sending the email:

{
  "status": "error",
  "message": {
               "test@example.com": "Already invited",
               "test2@example.com": "Member already exsists"
             }
}