---
title: "Add a deletion request"
method: POST
path: "/privacy/delete-request"
tags: ["Privacy Request"]
---

# Add a deletion request

`POST /privacy/delete-request`

Make a call to this endpoint to create a new privacy deletion request. This will delete a subscriber within thirty days, provided the call was successful. Use the GET endpoint with the id returned to confirm deletion.

## Request body

- PrivacyRequestAddDeleteEventDto
  - `subjectEmail` string — Email of a subscriber. Only required if __subjectPhone__ is empty.
  - `subjectPhone` string — Phone of a subscriber. Only required if __subjectEmail__ is empty.
  - `requestMsg` string — An optional message for an audit trail.
  - `clientUserId` string — ClientUserId of a subscriber. Only required if __subjectEmail__ and __subjectPhone__ is empty.

## Response `200`

Delete request added successfully

- PrivacyRequestDto
  - `id` string — ID of the privacy request.
  - `processed` boolean — Status of the request.
  - `type` string — Type of the request.
  - `subjectEmail` string — Email of a subscriber.
  - `subjectPhone` string — Phone of a subscriber.
  - `requestMsg` string — An optional message for an audit trail.
  - `requestDateTime` string — Timestamp of when the request was made.
  - `processingStartDateTime` string — Timestamp of when processing of the request began.
  - `processingEndDateTime` string — Timestamp of when processing of the request completed.

## Other responses

- `400` — Invalid request body
- `401` — Unauthorized
- `403` — Access Denied
- `404` — The specified resource was not found
- `429` — The user has sent too many requests in a given amount of time
- `500` — Internal Server Error

---

[API](https://skmtc.net/attentive/apis/attentive-api-v2.md) · [All operations](https://skmtc.net/attentive/apis/attentive-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attentive/attentive-api-v2/revisions/be387e501197/schema)
