---
title: Unsubscribe
description: "*Releva* provides an API you can call to unsubscribe users. ### Do I need to call it? You need to tell*Releva* when a user has unsubscribed so that they are excluded from marketing communication send through *Releva*. ### Request Format…"
url: "https://releva.ai/documentation/consent-status/unsubscribe/"
updated: "2026-09-22"
category: Developer Documentation / Profiles / Consent status
---

# Unsubscribe

*Releva* provides an API you can call to unsubscribe users.

### Do I need to call it?

You need to tell*Releva* when a user has unsubscribed so that they are excluded from marketing communication send through *Releva*.

### Request Format

The API accepts the following curl equivalent:

```js
# using email
curl -H 'Content-Type: application/json' -H 'Authorization: Bearer <secretKey>' -XPOST https://releva.ai/api/v0/unsubscribe -d'{ "email": "support@releva.ai" }'
# using phone number
curl -H 'Content-Type: application/json' -H 'Authorization: Bearer <secretKey>' -XPOST https://releva.ai/api/v0/unsubscribe -d'{ "phoneNumber": "+1585123" }'
```

### Response Format

A successful request will return a JSON response with HTTP status 202 and an empty body ({}). If an error is encountered, an appropriate HTTP status code will be returned along with a body describing the error ({"message": "…"})

If the email address in the request is not tracked in *Releva*, the request will have no effect.