Google Classroom add-ons are now generally available to developers! Please see the add-ons documentation for more information.

Method: courses.students.create

Adds a user as a student of a course.

Domain administrators are permitted to directly add users within their domain as students to courses within their domain. Students are permitted to add themselves to a course using an enrollment code.

This method returns the following error codes:

  • PERMISSION_DENIED if the requesting user is not permitted to create students in this course or for access errors.
  • NOT_FOUND if the requested course ID does not exist.
  • FAILED_PRECONDITION if the requested user's account is disabled, for the following request errors:
    • CourseMemberLimitReached
    • CourseNotModifiable
    • UserGroupsMembershipLimitReached
    • InactiveCourseOwner
  • ALREADY_EXISTS if the user is already a student or teacher in the course.

HTTP request

POST https://classroom.googleapis.com/v1/courses/{courseId}/students

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
courseId

string

Identifier of the course to create the student in. This identifier can be either the Classroom-assigned identifier or an alias .

Query parameters

Parameters
enrollmentCode

string

Enrollment code of the course to create the student in. This code is required if userId corresponds to the requesting user; it may be omitted if the requesting user has administrative permissions to create students for any user.

Request body

The request body contains an instance of Student .

Response body

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

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/classroom.rosters
  • https://www.googleapis.com/auth/classroom.profile.emails
  • https://www.googleapis.com/auth/classroom.profile.photos

For more information, see the Authorization guide.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025年04月17日 UTC.