Student Mutations

The student mutations let you provision and manage student accounts in your Teachify school programmatically. These operations cover the user lifecycle independently from course enrollment or membership plans — useful for CRM sync, bulk imports, and any flow that needs a user record before deciding what access to grant.

A “student” is a User with the student role. The created user is reachable via the standard users query — there is no separate students query. To list students, query users and filter by role; to provision a student, use the mutations below.

Available Mutations

• createStudent — Create a new student, or return the existing user if the email already matches one in this school. Idempotent and silent (no email sent).

Related operations

Student-facing operations that modify a course’s enrollment state — rather than the student record itself — live under the Courses mutation group:

• enrollStudentToCourse
• removeStudentFromCourse
• expireStudentCourseAccess
• extendStudentCourseAccess

Scoping and isolation

All student mutations are scoped to the school identified by the API credential. Email addresses are not globally unique across schools, and a matching email in another school will never be returned or modified.

Error Handling

Student mutations return errors via the standard GraphQL errors array. The error code is in extensions.error.code and follows the STUDENT-XXX convention.

For more information about the Teachify Admin API, please refer to the API Overview.