Launching Greenhouse Developers

Gordon Zheng
Feb 17, 2016 · 2 min read

Having recently left a previous life in developer relations to join Greenhouse, I was especially surprised to learn that Greenhouse provides several APIs but none of them were publicly documented. The documentation was difficult to reach inside of our app and it was organized in a way that made it time-consuming to navigate. It wasn’t long before Rachel Leffel and I decided to revamp the experience.

Today, we’re excited to launch Greenhouse Developers. It’s our first step toward crafting a top-notch product integration experience. By exposing API documentation in a single publicly-accessible destination, current and potential customers have a powerful resource to brainstorm new solutions to seamlessly tie in Greenhouse with other products and services they use.

Following the lead of API providers like DigitalOcean and Coinbase, we’ve built our docs using Slate, a framework for creating beautiful single-page API docs. Anyone who’s seen our documentation before will be delighted to discover that it’s been re-designed to be easier to navigate and digest. Check it out on your phone, too! It’s responsive and mobile friendly so you can read the docs whether you’re relaxing on a pink-sand beach in the Carribean or you’re about to skydive for the first time, and from 20,000 feet in the air you want to read your favorite passage of the Harvest API docs, possibly for the last time.

This site is intended to be a living record of our APIs as they grow. As an open source project on GitHub, every change is tracked and can be referenced in the git commit log. This also means we invite you, the reader, to suggest changes on GitHub. Found a bug? Create an issue to let us know. If you’re feeling adventurous, fork our repo and make a pull request! (It would really make my day if you did that :) )

While it only hosts documentation today, we’ve got a greater vision for — a centralized destination for developers, where you can find sample code for API bindings, and sample projects which demonstrate how to use those libraries. Eventually, step by step tutorials and guidelines for best practices will live here.

This is the first step in a series of exciting things in store for our customers. Rumor has it that the greenhouse_io Ruby gem may soon be seeing some improvements.

We can’t wait to see what you’ll build with Greenhouse!

Originally published at on February 17, 2016.

In the Weeds

A blog by the Greenhouse Engineering team

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store