> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truv.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TazWorks Integration

> Verify employment history directly within the TazWorks platform using Truv

Submit employment history verification requests for applicants directly within TazWorks. Truv uses [Hosted Orders](/developers/integration/hosted-orders/new-user) to contact applicants and guide them through payroll provider verification.

<Info>
  **Integration type:** Platform integration (no code required) | **Products:** VOE | **Platform:** [TazWorks](https://www.tazworks.com/)
</Info>

***

## Key benefits

* **Efficient verification** — Verify employment history details without manual outreach
* **Reliable data** — Obtain accurate information from payroll providers directly
* **Accelerated process** — Speed up verification turnaround for faster screening decisions

***

## Setup guide for TazWorks administrators

<Steps>
  <Step title="Configure interface settings">
    Navigate to **Admin > Vendors > Manage Interface Settings**. Enter your Truv credentials under the **Data Providers** tab.

    <Note>
      Confirm with TazWorks support that the Truv vendor is enabled on the backend before proceeding.
    </Note>
  </Step>

  <Step title="Manage vendors">
    Navigate to **Admin > Vendors > Manage Vendors**.

    1. Add a new vendor with basic information and select **Save**
    2. Select the **Searches** tab and choose applicable searches
    3. For each search, select **Embedded Interface**
    4. Select **Truv** from the Data Provider dropdown
    5. Select **Save**
  </Step>

  <Step title="Configure vendor routing">
    Navigate to **Admin > Vendors > Manage Vendor Routing**.

    1. Select **Employment Verification**
    2. Select **Add**, then **Save**

    Your TazWorks environment is now ready to place verification orders through Truv.
  </Step>
</Steps>

***

## Place a verification order

<Steps>
  <Step title="Create a new order">
    Log into TazWorks and navigate to **Order > New Order > Client and Product**. Select **Employment Verification** and click **Next**.
  </Step>

  <Step title="Enter applicant details">
    Complete the required fields including:

    | Field           | Required    | Notes                             |
    | --------------- | ----------- | --------------------------------- |
    | Applicant email | Yes         | Used for verification outreach    |
    | Applicant phone | Recommended | Improves conversion rates via SMS |
    | Current address | Yes         | —                                 |
    | Zip code        | Yes         | —                                 |

    <Warning>
      Collect applicant consent before submitting their email and phone number.
    </Warning>
  </Step>

  <Step title="Enter employer details">
    Mark the applicant's employment status and complete all employer details.

    Set **"May We Contact This Employer?"** to **No**. Truv contacts the applicant directly to complete verification through their payroll provider.
  </Step>

  <Step title="Complete the order">
    Select **Next**, then **Complete Order**. Truv sends the applicant an email and SMS guiding them through the verification widget.
  </Step>
</Steps>

***

## Monitor verification status

Navigate to **Workspace > Vendor Summary** and search for **Truv** to view order status.

| Status                   | Meaning                                                      |
| ------------------------ | ------------------------------------------------------------ |
| New Dispatched Order     | Applicant has not yet completed verification                 |
| Pending Review           | Applicant completed the widget — results ready for retrieval |
| ERROR ("EMAIL, MISSING") | Applicant email was not provided at order creation           |

<Note>
  Orders must reach **Pending Review** status before results can be retrieved. Successful widget completion changes the order from "New Dispatched Order" to "Pending Review".
</Note>

***

## Retrieve reports

1. Navigate to **Workspace > Vendor Summary > Truv**
2. Search for the application and select the applicant name
3. Select **Results** to view the employment verification data
4. Select **Print** to download the report as a PDF

Results appear under the **Employer-provided information** section.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Order shows as expired">
    Expired orders display as **Pending Review**. Check the order creation date and applicant activity. Re-create the order if the applicant did not complete verification within the expiration window.
  </Accordion>

  <Accordion title="Missing email error">
    Orders created without an applicant email show status **ERROR** with name **"EMAIL, MISSING"**. Navigate to **Workspace > Vendor Summary > Truv** and select the error entry to view details. Re-create the order with a valid applicant email.
  </Accordion>
</AccordionGroup>

***

## Next steps

<CardGroup cols={2}>
  <Card title="Screening Overview" icon="magnifying-glass" href="/screening/overview">
    Learn about Truv's screening products and capabilities
  </Card>

  <Card title="Test Credentials" icon="flask" href="/developers/testing/test-credentials">
    Test the integration with sandbox credentials
  </Card>
</CardGroup>