How can we help you?

Sora

Sora is a HR automation tool that makes it easy for you to build and personalize workflows for onboarding, offboarding, and all the key moments in between. It works with your existing HR tools, like Greenhouse, so you can automatically send a welcome email, schedule a new manager training, or even deliver an anniversary cupcake to the right employee at the right time. 

By integration Greenhouse with Sora, you’re able to import a new hire right from Greenhouse, into Sora, and add them to your onboarding workflow, to begin sending automated emails, collecting necessary information, and assigning tasks.[a]

Configuring your Greenhouse integration

To configure Greenhouse with Sora you'll need to create an API key and set up a webhook.

You'll need to be a Site Admin in Greenhouse to access the controls to do this.[b]

Creating your Greenhouse API key

To give Sora API access to retrieve information from your Greenhouse you will need to provide an API key and set permissions.‍

 

1. Click on the gear icon to get to the Settings screen


 

2. Navigate to Dev Center in the Sidebar

 


 

3. From the Dev Center, click on “API Credential Management”


 

4. Click the “Create New API Key” button

 

5. Name API Credential

When a modal titled Create new credential shows up, input the following description and type before clicking Create:

Description: Sora

Type: Harvest

 

 

6. Copy your API key

You should now be in a view called Manage API Key Permissions. Click the green box with the key icon and API Key to copy it.

You will need to paste this API key into Sora in Settings > Integrations > Greenhouse.

7. Set permissions

Below this you will see a series of permissions you can toggle on and off. Please set up permissions as follows before clicking Update.

Under Candidate:

Select GET: Retrieve Candidate — This allows you to retrieve Candidate specific data.

Select GET: List Candidates — This allows you to retrieve a list of Candidates.

Under Custom fields:

Select GET: Custom fields — This allows you to retrieve custom field data.

Creating a webhook

You will also need to set up webhooks so we can listen to updates from your Greenhouse instance when there is a change made to a Candidate.

1. Click on the gear icon to get to the Settings screen

2. Navigate to Dev Center from the sidebar

3. From the Dev Center, click on “Web Hooks”

4. Then click on “Web Hooks”

5. Configure your web hook

You should now be on a page titled Create A New Web Hook. Fill out the following details before clicking Create Web hook:

  • Name this web hook: Sora Candidate Hired
  • When: Candidate has been hired
  • Endpoint URL: You will need to get this from Sora.
  • Secret key: You will need to get this from Sora.
  • Error recipient email: integration-errors@sora.co
  • Disabled?: No.

You will need to paste this Webhook Client ID into Sora in Settings > Integrations > Greenhouse.

Great, you’re done! Now save your settings in both Greenhouse and Sora and you’re good to go. 

By default, after configuring your Greenhouse integration, Sora will map the candidates “Name” and “Email” data fields from Greenhouse into Sora. But working with your Sora implementation expert you are able to map any field or custom field in Greenhouse to an employee field in Sora.

Now you’ll be able to import a new hire right from Greenhouse into Sora and add them to your onboarding workflow.