Dover integration overview

Overview

Dover is an all-in-one recruiting platform for startups that combines an applicant tracking system (ATS) with recruiting partners to help streamline hiring workflows. Persona’s Dover integration helps recruiting operations, talent, and compliance teams connect identity workflows in Persona to recruiting workflows in Dover—so verified candidate context can flow into the right job and stage without manual copy-paste.

With this integration, you can pull jobs (including their hiring pipeline stages) from Dover and add candidates to the appropriate job stage from within Persona Workflows. This is especially useful when you want to route candidates based on Persona outcomes (for example, only adding candidates who pass an identity check to an interview stage).

Benefits

Faster Candidate Routing: Automatically add candidates to the right Dover job and pipeline stage based on Persona workflow outcomes—reducing manual data entry and delays.

Cleaner Hiring Operations: Use structured job and stage metadata from Dover to keep your workflows consistent across roles and hiring teams.

Reduced Tool Switching: Let recruiting and operations teams take key actions (like adding candidates) directly from Persona so processes stay centralized and auditable.

Integration Features

Persona’s Dover integration connects Dover recruiting workflows to Persona Workflows. Key capabilities include:

  • List Jobs: Retrieve your Dover jobs along with their hiring pipeline stages so workflows can dynamically select the right job and stage.
  • Add Candidate: Create a candidate in Dover for a specific job and place them into a chosen pipeline stage (by stage ID or stage name).
  • Pass Candidate Context: Send candidate details such as name, email, LinkedIn URL, resume URL, and additional comments as part of the add-candidate action.

Setting up the Dover integration

Prerequisites

To set up the Dover integration, ensure you have:

  • Admin access to your Dover account
  • Necessary API permissions to access Dover credentials

Setting up the Dover credentials

  1. In Dover, retrieve your API key:
    1. Go to https://app.dover.com/settings/company/api-key.
    2. Select Reveal App Key.
    3. Copy the API key value.
  2. In the Persona Dashboard, navigate to Integrations > Marketplace and select Dover.
  3. Click Add Credential.
  4. Enter a credential nickname (so teammates can recognize this connection).
  5. Paste your Dover API key, then save.
  6. Click Test to confirm the credential is working (recommended).

Using the Dover integration in a workflow

  1. Create a new workflow, or open an existing workflow you’d like to update.
  2. Add a new Action step > Integrations.
  3. Select the Dover integration and choose your saved Dover credential.
  4. Choose the Dover operation you want to run (for example, List Jobs or Add Candidate), then map fields from Persona into the input fields.
  5. Save and publish the workflow.

Dover Operations Overview

In addition to syncing field values, Persona can fetch job listings and pipeline stages and add candidates to Dover jobs using Dover’s API. These actions support seamless two-way workflows, letting teams manage investigations without switching platforms. See below for a comprehensive list of available Workflow Action steps and possible configurations for the Dover integration:

List Jobs Workflow Action Step

Use this action to retrieve jobs from Dover, including the hiring pipeline stages associated with each job. This is commonly used to power dynamic dropdowns or routing logic in workflows—for example, selecting a job, then selecting a stage within that job for downstream actions.

Configuration Steps:

  • Optionally add:
    • Limit (how many jobs to return per page)
    • Offset (where to start in the results list)

Add Candidate Workflow Action Step

Use this action to add a candidate to a specific job in Dover and place them into the appropriate hiring pipeline stage. This is helpful when your workflow determines a candidate should be progressed (or queued for review) and you want Dover to reflect that outcome immediately.

Configuration Steps:

  • Provide values for required fields:
    • Job ID
    • Candidate first name
    • Candidate last name
    • Exactly one of the following stage selectors:
      • Hiring pipeline stage ID, or
      • Hiring pipeline stage name
  • Optionally add:
    • Candidate email
    • Candidate LinkedIn URL
    • Resume URL (must be a PDF, DOC, DOCX, or TXT file)
    • Additional comments

FAQs

What permissions are required in Dover?

You’ll need access to your company’s Dover API key in Dover settings, as well as the ability to use that key to make requests to Dover’s External API.

How do I find the Job ID and hiring pipeline stage information?

Use the List Jobs action to retrieve jobs and their associated pipeline stages. The results include each job’s ID and stage IDs/names, which you can then use when configuring Add Candidate.

Can I choose a stage by name instead of ID?

Yes. When adding a candidate, you can specify the hiring pipeline stage using either the stage ID or the stage name (but you must provide exactly one of the two).

Can I include a resume when adding a candidate?

Yes—if you have a publicly accessible resume link, you can provide it as a resume URL. Dover’s API specifies the resume must be in PDF, DOC, DOCX, or TXT format.