Method: invitations.create

Creates an invitation. Only one invitation for a user and course may exist at a time. Delete and re-create an invitation to make changes.

This method returns the following error codes:

  • PERMISSION_DENIED if the requesting user is not permitted to create invitations for this course or for access errors.
  • NOT_FOUND if the course or the user does not exist.
    • if the requested user's account is disabled.
    • if the user already has this role or a role with greater permissions.
    • for the following request errors:
      • IneligibleOwner
  • ALREADY_EXISTS if an invitation for the specified user and course already exists.

HTTP request


The URL uses gRPC Transcoding syntax.

Request body

The request body contains an instance of Invitation.

Response body

If successful, the response body contains a newly created instance of Invitation.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authorization guide.