Skip to contentDevelopersPrezly website
Privacy requests

Create Privacy Request

Record an unconfirmed request to export, correct, delete, or discuss contact data.

Personal tokens are not supported for this endpoint. Use an integration API key. Your account must also have access to the requested data. Authentication

Creates an unconfirmed record without sending a confirmation email. message is optional for delete/export and required for correct/other; correction also requires extra_message.

Read the guide

POST
/newsrooms/{newsroom_id}/privacy-requests

Returns HTTP 200 with an unconfirmed privacy_request. This API call does not send a verification email; the hosted privacy form separately initiates that email. Verify the requester before calling confirmation.

Personal access tokens are not supported for this endpoint. Use an integration API key with the required permissions.

Authorization

API_key
headerAuthorizationBearer <token>

Bearer authentication using an integration API key, or a personal access token only where the operation explicitly supports it. Every listed personal-token scope is required; owner permissions and newsroom access still apply.

Path Parameters

newsroom_id*string

Newsroom UUID or ID

Length1 <= length

Request Body

application/json
  1. body
email?string
Formatemail
type*"correct"
Value in"correct"
message*unknown
Length1 <= length
extra_message*unknown
Length1 <= length
locale?string

Locale code or slug. Omission uses the newsroom default locale.

Response Body

OK

application/json
  1. response
privacy_request?
Example Request
curl -X POST 'https://api.prezly.com/v2/newsrooms/string/privacy-requests' \  -H 'Content-Type: application/json' \  -d '{  "email": "user@example.com",  "type": "correct",  "message": "string",  "extra_message": "string"}'
Example Response200
{  "privacy_request": {    "id": "string",    "status": "unconfirmed",    "email": "string"  }}