Skip to content

Create Course

The createCourse mutation allows you to create a new course in your school with the specified properties.

Input Parameters

Field	Type	Description
`input`	`AdminCourseInput!`	Input object containing course creation details

AdminCourseInput Fields

Field	Type	Required	Description
`name`	`String!`	Yes	Course name
`slug`	`String!`	Yes	URL slug for the course. Must contain only lowercase letters, numbers, and hyphens
`courseType`	`String!`	Yes	Type of the course (paid, public_access, free_redeem, pre_order)
`description`	`String`	No	Course description
`categoryIds`	`[String!]`	No	IDs of categories to associate with this course
`tagList`	`[String!]`	No	Tags to associate with this course

Return Type

type AdminCourseCreatePayload {
  # The created course object, null if operation failed
  course: AdminCourse

  # Array of error messages, if any occurred during the operation
  errors: [String!]
}

Example

mutation CreateCourse {
  createCourse(input: {
    name: "GraphQL Fundamentals"
    slug: "graphql-fundamentals"
    courseType: "paid"
    description: "Learn the basics of GraphQL API development"
    categoryIds: ["cat_123"]
    tagList: ["graphql", "api", "development"]
  }) {
    course {
      id
      name
      slug
      courseType
      description
    }
    errors
  }
}

Sample Response

{
  "data": {
    "createCourse": {
      "course": {
        "id": "course_12345",
        "name": "GraphQL Fundamentals",
        "slug": "graphql-fundamentals",
        "courseType": "paid",
        "description": "Learn the basics of GraphQL API development"
      },
      "errors": []
    }
  }
}

Common Errors

Error	Description
`Name cannot be empty`	The course name is required
`Slug already exists`	The provided slug is already in use
`Invalid course type`	The courseType must be one of: paid, public_access, free_redeem, pre_order
`Category not found`	One or more category IDs do not exist

Update Course - Update an existing course
Delete Course - Delete a course
Course Management - Overview of course operations

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