Skip to content

School

Schools are the most basic groupings of courses, groups, and users. All courses/users are required to have unique usernames, course IDs, and School User IDs throughout the entire school.

Fields

FieldNameDescriptionType
idSchool IdThe internal Schoology ID that identifies the school. This field cannot be used in create operations; only update and read operations.string
title*School TitleThe name of the schoolstring
address1Street address line 1The first line of the school's street addressstring
address2Street address line 2The second line of the school's street addressstring
cityCityThe city where the school is locatedstring
stateStateThe state/province where the school is locatedstring
postal_codePostal codeThe postal code where the school is locatedstring
countryCountryThe country where the school is locatedstring
websiteWebsiteThe school's website addressstring
phonePhone numberThe school's phone numberstring
faxFax NumberThe school's fax numberstring
picture_urlProfile Picture URLThe full URL of the school's profile picturestring

* = Required

GET schools

?

GET schools/{id}

View a specified school

Return A school

json
{
  "id": "344232",
  "title": "Hill Valley High School",
  "address1": "700 Western Ave",
  "address2": "",
  "city": "Petaluma",
  "state": "CA",
  "postal_code": "94952",
  "country": "US",
  "website": "",
  "phone": "234234324234",
  "fax": "",
  "building_code": "",
  "picture_url": ".. URL ..."
}
xml
<?xml version="1.0" encoding="utf-8" ?>
<result>
  <id>344232</id>
  <title>Hill Valley High School</title>
  <address1>700 Western Ave</address1>
  <address2 />
  <city>Petaluma</city>
  <state>CA</state>
  <postal_code>94952</postal_code>
  <country>US</country>
  <website />
  <phone>234234324234</phone>
  <fax />
  <building_code />
  <picture_url>.. URL ...</picture_url>
</result>

POST schools

Create a school

Content A school

json
{
  "title": "Example school name",
  "address1": "750 West Road",
  "city": "New York",
  "state": "New York"
}
xml
<body>
  <title>Example school name</title>
  <address1>750 West Road</address1>
  <city>New York</city>
  <state>New York</state>
</body>

PUT schools/{id}

Edit a specified school

DELETE schools/{id}

Delete a specified school

Objects and realms