Setting up the Greenhouse App Tile

As part of Simpplr's app tiles feature, we offer several out-of-the-box app tiles your org can set up on home and site dashboards. The article linked below gives an overview of how app tiles work, permissions around setting them up, and various requirements. 

Setting Up Out-of-the-Box App Tiles on Dashboards

This article explains the Greenhouse tile.

The Greenhouse integration is built on the Bring Your Own Integration (BYOI) framework, offering the following key benefits to customers:

1. Extensibility beyond pre-built use cases – In addition to the existing pre-built app tiles, customers can extend these integrations by building custom API actions and custom app tiles tailored to their specific needs.
2. Bring-Your-Own-App support – For OAuth-based apps, scopes and permissions can be controlled at the connector level. However, for user-level connections, data access remains restricted to the permissions individual users hold within the external apps, ensuring flexibility and security.

Greenhouse tile

Display job openings in Greenhouse

Allows users to view internal and external job openings from Greenhouse on a tile.

Displays:

• Job ID
• Title
• First published date
• Location

Interactions:

• Clickable job title: redirects to job details page in Greenhouse.
• Pagination: Display up to 4 jobs with a "Show more" link for additional jobs.

Prerequisites & Setup:

• An API Key is required to access the Greenhouse Harvest API. A Greenhouse Admin must generate a Harvest API Key with the necessary permissions to access Job Posts data. Refer to the Greenhouse API documentation for instructions on creating an API key and configuring the required permissions (Harvest -> Job posts) for the Job Posts endpoints. Make sure to choose API type as Harvest while creating the API key.
• The API key will be used to create the connection for Greenhouse in Simpplr. To create the connection,
  • Encode the string <your-api-key>: using base64. (note, the colon there : is important to include. The string value should read <your-api-key>: exactly as formatted here)
  • Input the Basic <base64-encoded-string> in the API Token input.

• App admin must have enabled and configured the Greenhouse integration from:
  Manage > Application > Integration > Custom Apps
   
• Navigate to Add New App > Add Prebuilt App, then select and add the Greenhouse app.
• Once enabled, the app will be available under the Add Tile option on the home or site dashboard.