1. Greenhouse Support
  2. All Recruiting topics
  3. Integrations
  4. Other integrations

Adway integration

Adway provides a cutting-edge recruitment marketing platform that leverages artificial intelligence to automate and optimize the entire talent attraction process. By combining data-driven job advertising, employer branding, and real-time performance insights, Adway helps organizations reach the right candidates at the right time—across social media, job boards, and digital channels.

Adway’s integration with Greenhouse Recruiting allows users to: 

  • Fetch job posts from Greenhouse account via API
  • Create Ad campaigns based on the jobs retrieved
  • Gather candidate's applications (along with screening questions and CVs) and transfer them to Greenhouse via API 

In this article

Find your board token

You can find your Job Board URL and token by navigating to the Job Board settings. (Configure > Job Boards & Posts > Ellipsis icon next to job board > Edit Board Settings) and scroll to the URL field. Copy the value as you’ll need to paste it in Adway.

Create a Harvest API key

To configure the  integration, you’ll need to create a Harvest API key. 

Follow the steps in this article to create the key, and verify that the permissions below are selected when configuring the Adway integration. Be sure to copy the API key as you’ll need to paste it in Adway in the next step.

Credentials

In the Create New Credential box, make the following selections:

  • API Type: Harvest
  • Partner: Adway or Unlisted Vendor
  • Description: Adway Harvest API Key

Permissions

Verify that the following permissions are selected for the Adway integration: 

  • Applications
    • Get: Retrieve Application
    • Get: List Applications
  • Candidates
    • Get: Retrieve Candidate
    • Patch: Edit Candidate
    • Post: Add Candidate
    • Post: Add E-mail
    • Post: Add Note
    • Post: Add Attachment
    • Post: Add Application
    • Post: Add Education
    • Post: Add Employment
  • Job Openings
    • Get: List Openings For a Job
  • Job Posts
    • Get: List Job Posts
    • Get: Retrieve Job Post for Job
    • Get: List Job Posts for Job
  • Jobs
    • Get: Retrieve Job
    • Get: List Jobs
    • Get: Get hiring team

Hiring Manager configuration and permissions

The integration only works when the hiring manager assigned to the job post is properly configured. If the hiring manager does not have the necessary permissions to upload candidates, ensure that the user ID of a user with the appropriate permissions is provided. Our system will be able to perform actions on behalf of this user, allowing the process to continue smoothly.

Fields Mapping

This table outlines the mapping of fields from the Greenhouse object to our internal data structure. For each field in the input object, the corresponding mapped field in our system is listed, along with a brief description of its purpose. This ensures clarity on how data is transferred and transformed during the integration process.

Source Field Mapped Field Description
id atsJobPostId The unique ATS job post ID.
city adLocations.city City of the job location.
country adLocations.country Country of the job location.
first_published_at pubDate Publication date of the job posting.
title title Title of the job posting.

Additionally, we process screening questions and public data via the Job Board to enrich the job posting information.

It’s important to note that this field mapping can be customized by our clients according to their specific needs. Clients have the flexibility to adjust how the data is mapped to fit their flows and requirements.

Connect Greenhouse Recruiting to Adway

To connect your ATS (Applicant Tracking System) with Adway’s platform, follow these steps:

1. Navigate to the Connectors Page

Go to the Connectors section of the platform and click the “Add” button to start creating a new integration.

2. Select Your ATS

Choose the ATS you want to integrate with — in our case, Greenhouse.

3. Enter Credentials

Provide the required authentication details:

  • API Token – from your Greenhouse account

  • Board Token – used to fetch job postings details

  • User ID – the identifier of the user who will submit candidate forms

4. Add Filters (Optional)

You can apply filters to control which data is fetched or processed. This step is optional and can be skipped if not needed.

Use the integration

Once configured, you can:

  • Run the connector manually

  • Or wait for it to trigger automatically based on the schedule

Upload candidates to Greenhouse Recruiting

Once all automation and nurturing processes are configured, you can begin creating social media campaigns to attract candidates through the platform.

Candidate Application Flow

When a candidate applies via your campaign landing page, there are two possible outcomes, depending on how the application criteria are configured:

1. Automatic Submission to Greenhouse

If:

  • Application criteria are configured, and

  • The candidate meets the qualification requirements for the position

Then the system will automatically:

  • Create a candidate profile in Greenhouse

  • Submit the application

  • Upload questionnaire answers

  • Attach any uploaded files (e.g., resume, cover letter)

This process is handled automatically and requires no manual action.

2. Manual Submission

If:

  • Application criteria are not configured, or
  • The candidate does not meet the required qualifications

Then no data is sent to Greenhouse automatically.

However, the candidate is still stored within the platform and can be manually submitted to Greenhouse at any time via the Candidates page.

Additional resources

For more information or troubleshooting not covered here, you can:

Contact Adway directly through Intercom on the dashboard

Visit the Adway Documentation