---
title: "Enable or disable the employee verification integration"
method: PUT
path: "/api/v1/employee-verifications/integration"
tags: ["Employee Verification", "Public API"]
---

# Enable or disable the employee verification integration

`PUT /api/v1/employee-verifications/integration`

Enables or disables the company's employee verification integration. Enabling installs the configured partner app and schedules the daily sync; the company must have a valid US work location before enabling, otherwise a 400 is returned. Disabling tears down the partner app. The call is idempotent: a request to enable when already enabled (or disable when already disabled) returns 200 with the current state. Requires the employee_verifications.write OAuth scope, intended for admin-level API consumers.

OAuth Scopes: employee_verifications.write

## Request body

- object
  - `enabled` boolean, required — Desired enabled state for the integration.

## Response `200`

Success

- object
  - `integration` EmployeeVerificationIntegration, required — Install state and partner metadata for the company's employee verification integration.
    - `enabled` boolean, required — True when the integration is installed for the company and partner endpoints are usable.
    - `integrationType` string, required — Identifier of the configured employee verification partner (opaque string; matches `integrationType` from the integration GET response).

## Other responses

- `400` — Invalid request body or partner configuration prevented the change.
- `403` — Forbidden
- `500` — Internal server error

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)