---
title: "Create a custom evidence request for an audit"
method: POST
path: "/audits/{auditId}/evidence/custom-evidence-requests"
tags: ["Audits"]
---

# Create a custom evidence request for an audit

`POST /audits/{auditId}/evidence/custom-evidence-requests`

Create a custom evidence request for an audit.

Rate limit: 10 requests / minute.

## Path parameters

- `auditId` string, required

## Request body

- CreateCustomEvidenceRequestInput
  - `controlIds` string[], required — A set of controls, referenced by id, to map the evidence to
  - `title` string, required — Title for the evidence request
  - `description` string, required — Description for the evidence request
  - `cadence` 'P0D' | 'P1D' | 'P1W' | 'P1M' | 'P3M' | 'P6M' | 'P1Y' | 'P2Y', required
  - `reminderWindow` 'P0D' | 'P1D' | 'P1W' | 'P1M' | 'P3M' | 'P6M' | 'P1Y' | 'P2Y', required
  - `isRestricted` boolean, required — Whether this document contains sensitive data and needs more restrictive read access
  - `auditorEmail` string, required — Email of the auditor who created the custom evidence request.

## Response `200`

Ok

- CustomEvidenceRequest
  - `id` string, required — Internal id of the custom evidence request within Vanta
  - `controlIds` string[], required — A set of controls, referenced by id, to map the evidence to
  - `title` string, required — Title for the evidence request
  - `description` string, required — Description for the evidence request
  - `cadence` 'P0D' | 'P1D' | 'P1W' | 'P1M' | 'P3M' | 'P6M' | 'P1Y' | 'P2Y', required
  - `reminderWindow` 'P0D' | 'P1D' | 'P1W' | 'P1M' | 'P3M' | 'P6M' | 'P1Y' | 'P2Y', required
  - `isRestricted` boolean, required — Whether this document contains sensitive data and needs more restrictive read access

---

[API](https://skmtc.net/vanta/apis/build-integrations.md) · [All operations](https://skmtc.net/vanta/apis/build-integrations/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vanta/build-integrations/revisions/6c1f7590538b/schema)