---
title: "Send Document Rejection Notification"
method: POST
path: "/v2/applicants/{id}/document_rejection_notifications"
tags: ["Applicants"]
---

# Send Document Rejection Notification

`POST /v2/applicants/{id}/document_rejection_notifications`

Notify an applicant that a compliance document submission was rejected. Sends email (and SMS when the applicant has a phone number) through the account messaging settings.

## Path parameters

- `id` string, required

## Request body

- DocumentRejectionNotificationCreateRequest
  - `document_type_name` string, required — Name of the rejected document type, shown to the applicant
  - `rejection_reasons` string[] — Rejection reason codes selected by the reviewer (e.g. DOCUMENT_EXPIRED)
  - `custom_rejection_reason` string — Free-text reason provided by the reviewer for the OTHER reason code
  - `message` string — Reviewer-edited notification body; when omitted, a default message is composed from the rejection reasons

## Response `201`

Created

- DocumentRejectionNotificationCreateResponse
  - `message` string, required — Successful notification queued message

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/fountain/apis/hire-public-api.md) · [All operations](https://skmtc.net/fountain/apis/hire-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fountain/hire-public-api/versions/5f406c0e9462/schema)