📘

To enable the integration, make sure you have the required permissions in Greenhouse. If not, ask your Greenhouse Administrator to grant them before proceeding.

1️⃣ Create a Harvest API Key in Greenhouse

1. Go to the Greenhouse API Credentials page
2. Click Create New API Key.
3. Set API Type to Harvest.
4. Choose Partner = Starred.
5. Enter a short description, such as “Starred integration.”
6. Click Manage Permissions.

🖼️ Example:

7. On the next page, copy and store your new API Key before proceeding.

❗️

Important: If you lose the key, you’ll need to create a new one.

2️⃣ Adjust API Key Permissions

Assign the following permissions to your new API Key:

• Applications → Get: Retrieve Application
• Scheduled Interviews → Get: List Interviews for Application
• Departments → Get: List Departments
• Jobs → Get: Retrieve Jobs
• Job Posts → Get: List Job Posts
• Job Posts → Get: List Job Posts for Job
• Sources → Get: List Sources
• Users → Get: Retrieve User
• Custom Fields → Get: Get Custom Fields
• Candidates → Get: Retrieve Candidate

✅ Once permissions are added, save your changes.

3️⃣ Get Your Endpoint URL and Secret Key from Starred

1. In Starred, go to Settings → Integrations.
2. Under Greenhouse, click Connect.
3. Paste your Harvest API Key (the one you saved earlier) and click Continue.
4. Starred will generate an Endpoint URL and a Secret Key.

💡

Tip: Save both values securely — you’ll need them to configure your Greenhouse webhooks.

4️⃣ Configure Webhooks in Greenhouse

Next, create webhooks in Greenhouse that notify Starred of candidate events.

Go to the Webhooks Settings page in Greenhouse. You’ll need to create four webhooks using the same Endpoint URL and Secret Key from Starred.

For each webhook:

1. Click Create Webhook.
2. Fill in the details below.
3. Use the same Endpoint URL and Secret Key each time.

🔸 Webhook 1: Candidate Hired

Name: Candidate hired

When: Candidate has been hired

🔸 Webhook 2: Candidate Rejected

Name: Candidate rejected

When: Candidate or prospect rejected

🔸 Webhook 3: Offer Created

Name: Offer created

When: Offer created

🔸 Webhook 4: Candidate Applied

Name: Candidate applied

When: Candidate has submitted application

5️⃣ Validate the Webhooks in Starred

1. Go back to Starred Connect.

2. Click Validate webhooks.

   ✅ A green confirmation message will appear if everything is correct.

3. Click Finish setup.

🎉 That’s it! Your Greenhouse integration is now active. Starred will start sending surveys automatically based on your configured workflows.