---
title: "Send employee verification lifecycle email by user and email type"
method: POST
path: "/api/v1/employee-verifications/users/{userId}/send-email"
tags: ["Employee Verification", "Public API"]
---

# Send employee verification lifecycle email by user and email type

`POST /api/v1/employee-verifications/users/{userId}/send-email`

## Request

- Base URL: `https://companySubDomain.bamboohr.com`
- URL: `https://companySubDomain.bamboohr.com/api/v1/employee-verifications/users/{userId}/send-email`
- Auth: OAuth 2
  - Authorization code: `/authorize.php`
  - Token URL: `/token.php` scopes: `employee_verifications.write`
- TypeScript: <https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/employee-verifications/users/:userId/send-email/post.ts> (a function with typed inputs; its response is checked against the schema)

Accepts a Bamboo `userId` (path) and an `emailType` (body) and queues the corresponding employee verification lifecycle email—the same templates as the in-app auth listener (`signup_survey` after signup, `app_installed` after the integration app is installed). Delivered to the company owner contact with template context for that user id. Not an employee I-9 reminder. Requires the employee verification integration enabled, onboarding edit access, and `employee_verifications.write`.

OAuth Scopes: employee_verifications.write

## Path parameters

- `userId` integer, required

## Request body

- object
  - `emailType` 'signup_survey' | 'app_installed', required: Which employee verification lifecycle email to send; must be {@see EverifyEmailType::SIGNUP_SURVEY} or {@see EverifyEmailType::APP_INSTALLED} (string values `signup_survey`, `app_installed`).

## Response `202`

Request accepted; email has been queued for delivery.

- object
  - `status` string, required
  - `message` string

## Other responses

- `400`: Bad request (invalid body, unknown user id, or integration disabled)
- `403`: Forbidden
- `500`: Internal server error

---

[API](https://skmtc.dev/bamboohr/apis/bamboohr-api.md) - [All operations](https://skmtc.dev/bamboohr/apis/bamboohr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bamboohr/apis/bamboohr-api/revisions/922fc15f43a7?raw)