---
title: "Set a person's data consent"
method: PUT
path: "/v1/persons/{personId}/dataConsent"
tags: ["Persons"]
---

# Set a person's data consent

`PUT /v1/persons/{personId}/dataConsent`

Captures information about when a person granted/denied consent to have their personal data stored (required scope contacts:persons:write)

## Path parameters

- `personId` string, uuid, required

## Headers

- `Customer-Id` integer, required

## Request body

- UpdatePersonConsentModel — Update person consent model
  - `status` 'awaiting' | 'refused' | 'granted', required — The consent preference indicated by the person<p>Possible values:</p><ul><li><b>awaiting</b>: Awaiting</li><li><b>refused</b>: Refused</li><li><b>granted</b>: Granted</li></ul>
  - `medium` 'email' | 'click' | 'telephone', required — The medium that a person has expressed their consent using<p>Possible values:</p><ul><li><b>email</b>: Email</li><li><b>click</b>: Click</li><li><b>telephone</b>: Telephone</li></ul>
  - `comment` string, nullable — Descriptive text about how and/or why the person has made this consent decision

## Response `204`

No Content

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.net/bigchange/apis/bigchange-dx.md) · [All operations](https://skmtc.net/bigchange/apis/bigchange-dx/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigchange/bigchange-dx/revisions/916e669fc527/schema)