# gatsby-source-greenhouse

> Gatsby source plugin for loading job posts from greenhouse.io

Latest version **3.0.0** (published 2020-06-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install gatsby-source-greenhouse
pnpm add gatsby-source-greenhouse
yarn add gatsby-source-greenhouse
bun add gatsby-source-greenhouse
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 3.0.0 |
| Published | 2020-06-24 |
| First published | 2017-11-06 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 11.3 KB |
| Known vulnerabilities | 0 (+25 in 1 direct dependencies) |
| Install scripts | no |
| Author | Diego La Manno |
| Maintainers | diegolamanno |
| Keywords | gatsby, gatsby-plugin, gatsby-source-plugin, greenhouse, ats |

## Links

- npm: https://www.npmjs.com/package/gatsby-source-greenhouse
- Repository: https://github.com/diegolamanno/gatsby-source-greenhouse
- Issues: https://github.com/diegolamanno/gatsby-source-greenhouse/issues
- npm.io page: https://npm.io/package/gatsby-source-greenhouse

## Dependencies (2)

- [axios](https://npm.io/package/axios.md) ^0.16.2
- [gatsby-node-helpers](https://npm.io/package/gatsby-node-helpers.md) ^0.3.0

## Recent versions

- 3.0.0 (latest) — 2020-06-24
- 2.1.0 — 2020-06-24
- 2.0.2 — 2018-10-03
- 2.0.1 — 2018-09-26
- 2.0.0 — 2018-09-13
- 1.1.0 — 2017-11-06
- 1.0.0 — 2017-11-06

## README

# gatsby-source-greenhouse

> Loads job openings from greenhouse.io into Gatsby.js. Based on [gatsby-source-workable](https://github.com/tumblbug/gatsby-source-workable).

## Status

[![npm version](https://badge.fury.io/js/gatsby-source-greenhouse.svg)](https://badge.fury.io/js/gatsby-source-greenhouse)

## Installation

```bash
npm install gatsby-source-greenhouse
```

or

```bash
yarn add gatsby-source-greenhouse
```

## Usage

To use this source you need to supply a Greenhouse API token. You can create a Greenhouse API token by logging into Greenhouse and going to `Configure > Dev Center > API Credential Management > Create New API Key`. Make sure it is type **Harvest**.

API keys need to be authorized to access specific endpoints. Go to `API Credential Management > Manage Permissions` and make sure your key is authorized for the following endpoints:

* Jobs
* Job Posts
* Departments

Next, edit `gatsby-config.js` to use the plugin:

```
{
  ...
  plugins: [
    ...
    {
      resolve: `gatsby-source-greenhouse`,
      options: {
        apiToken: `{API_TOKEN}`,
        jobPosts: {
          live: true
        }
      },
    },
  ]
}
```

By default, `gatsby-source-greenhouse` will only retrieve job openings that are marked as _live_. You can change this by passing in `false` in the `jobPosts` plugin option parameter.

## Querying

You can query the all `JobPost` created by the plugin as follows:

```graphql
{
    allGreenhouseJobPost {
        edges {
            node {
                ...
            }
        }
    }
}
```

You can also query all `JobPost` broken out for each department:

```graphql
{
  allGreenhouseDepartment {
    edges {
      node {
        name
        childrenGreenhouseJobPost {
          title
        }
      }
    }
  }
}
```

---
_Source: https://npm.io/package/gatsby-source-greenhouse · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._