Developer Portal FAQs

What is the HMH Developer Portal?

The Developer Portal is an environment in which developers can access the information and resources they need to work with our APIs, and connect with HMH experts and the broader developer community.

Why sign up?

HMH serves more than 50 million students, teachers, parents, and lifelong learners around the world. By exposing our APIs, our goal is to provide greater opportunities for interoperability and ultimately a seamless user experience for our customers.

By connecting to our ecosystem, developers can build solutions which are compatible with those that administrators, educators and learners already know and trust. And by ensuring that our solutions work well together, we can create an even better user experience.

What exactly is an API?

At its most basic level, an API, or Application Program Interface, connects two or more products or services — opening up data and functionality to other developers or businesses and allowing those products to “talk” to one other.

What APIs will HMH make available?

The first resources that we will make available are Identity, Assignment, Document, and Learning Content, with more to come throughout 2015. Details about new resources will be posted to the Developer Portal and emailed to registered users.

What is the Identity API?

Description: The Identity API will help you get a sense of the user’s role within the ecosystem. Are they a teacher or a student? Which school and courses are they enrolled in? In general, identity will help you understand the role and enrollments of different users.

Why it Matters: HMH serves over 50 million users in all 50 states and over 150 countries worldwide, and has approximately 18 million registered users on our core platforms, so understanding our user base is essential to effectively integrating with our systems. Third party developers will be able to use the identity API to build applications that can help these users.

What is the Assignment API?

The Assignment API is temporarily unavailable.

Description: No doubt you will remember your own experiences with assignments: a set of math problems, an essay, or a list of verb conjugations in French, for example. Assignments are typically assigned by teachers and completed and submitted by students for feedback and grading. Initially, the assignment API resources let developers interact with the scores and point values associated to assignments.

Why it Matters: Luckily, technology can make assignments a lot more interesting and engaging, and help users do more with the data! Do you have an exciting virtual lab experiment or a language-tutoring tool that could enhance learning for some or all students in a classroom? If so, the assignment APIs might be worth exploring. Teachers looking for new, innovative or additional assignment options might want to provide supplementary lessons, but would like to pull the scores back into their Houghton Mifflin Harcourt accounts. Developers focused on data and reporting might use the API to create an app to visualize data or notify teachers of scoring trends in the class.

What is the Document API?

Description: Today’s tech-savvy students build and create all sorts of digital files and artifacts, like documents, videos, sound bytes, and photos, to document their work. The document service offers students and teachers a central place to store, tag and showcase all of their digital artifacts so they can more efficiently locate, reflect on and use these files across all subjects and classes.

Why It Matters: Storage services will be available to provide a simple way for third party developers to POST documents or tags created externally back into the HMH learning ecosystem, for access and use within other HMH programs and platforms. The Document API could also be used to submit work or assignments from a third party app back to students’ HMH accounts.

What is the Content API?

Description: HMH provides the Global learning community with valuable content and resources. The content service will provide developers with a very limited set to work with in the sandbox environment.

Why it matters: High quality content is the base of most learning experiences. We are interested in exploring what may be possible on top of that core valuable experience.

Getting Involved

How do I sign up?

You can sign up for an account at https://developer.hmhco.com/signup. For further detail, visit the API Guide.

How do I create an application?

After your account has been successfully created, you will be able to create an application by following the steps provided on the API Guide.

How do I edit or delete an application?

To have your account or application removed, please contact developer support at labs@hmhco.com.

What analytics are available?

The HMH Developer Portal provides detailed monitoring and traffic analytics by account, app, or service. This can be accessed in the Statistics dashboard upon login.

How do I get an API Key?

An API key (or User Key) is automatically generated for you when you create an application. Go to your Applications Page and select your application to view the key.

Where can I view sample code?

The Developer Portal provides interactive documentation to help you explore, test and integrate with your API. These can be found on the Resources page.

What is the sandbox endpoint?

In v4, the endpoint changed to http://sandbox.graph.hmhco.com.

Developer Support

Where can I go for help?

If you have any questions regarding the Developer Portal or the process, please post them on the Forum page or contact Developer Support at labs@hmhco.com.

How do I sign up to the Developer Forum?

The Forum is available to users with active accounts. Simply go to the Forum page and enter your login credentials to gain access. From here you can create/edit/delete categories, threads, and posts.

How do I get a token?

Information on getting a token can be found on the API Guide