---
title: "Request consent from multiple candidates"
method: POST
path: "/candidates/consent-requests"
tags: ["candidates"]
---

# Request consent from multiple candidates

`POST /candidates/consent-requests`

Read more about GDPR tools on [SmartRecruiters Help Center](https://customers.smartrecruiters.com/kb/articles/2273-compliance-and-gdpr-tools-for-companies)

## Request body

- object
  - `content` ConsentRequest[], required
    - `id` string, required — candidate id

## Response `201`

Consent requests has been scheduled.

The response contains a list of results for each individual consent request in the same order as in the request.

A single result `status` property value could be:
* 202 - consent request successfully scheduled,
* 403 - cannot request consent from candidate as no privacy policy has been configured.

- ConsentRequestsResults
  - `results` union[], required
    - union
      - ConsentRequestScheduled
        - `status` 202, required
        - `body` object, required
          - `location` string
      - ConsentRequestUnavailable
        - `status` 403, required
        - `body` false

---

[API](https://skmtc.net/smartrecruiters/apis/apply-api.md) · [All operations](https://skmtc.net/smartrecruiters/apis/apply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartrecruiters/apply-api/versions/449bdc2516c9/schema)