---
title: "Unsubscribe WhatsApp Users from Database V1"
slug: "unsubscribe-whatsapp-users-from-database-v1"
description: "Insider One's WhatsApp Unsubscribe API v1 reference: POST endpoint to globally unsubscribe one E.164 phone number per request; see v2 for bulk unsubscribes."
tags: ["whatsapp unsubscribe", "unsubscribe api", "unsubscribe whatsapp users"]
updated: 2026-09-09T12:07:36Z
published: 2026-09-09T12:07:36Z
canonical: "academy.insiderone.com/unsubscribe-whatsapp-users-from-database-v1"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://academy.insiderone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Unsubscribe WhatsApp Users from Database V1

The WhatsApp Unsubscribe API enables you to unsubscribe users from Insider One's [WhatsApp](https://academy.insiderone.com/docs/whatsapp-overview) product.

A [newer version of the Unsubscribe API](/docs/unsubscribe-whatsapp-users-from-database-v2) is available with support for bulk data ingestion. While the older version is still supported, we recommend using the latest version for improved functionality and future compatibility.

## Endpoint and Headers

> **POST** https://contact.useinsider.com/whatsapp/v1/unsubscribe [](https://developers.insiderone.com/#9d561ba4-146b-4be5-9ee2-a0a5131c4025)

> Visit our Postman collection to test this request.

### Headers

| Header | Sample Value | Description |
| --- | --- | --- |
| X-PARTNER-NAME | mybrand | This is your partner name. Navigate to **InOne** > **Inone Settings** > [**Account Settings**](/v1/docs/inone-account-settings) to copy your partner name. The partner name should be lowercase. |
| X-REQUEST-TOKEN | 1a2b3c4e5d6f | This key is required to authorize your request. Refer to [API Authentication Tokens](https://academy.insiderone.com/docs/api-authentication-tokens) to generate your **Global Unsubscribe** token. |
| Content-Type | application/json | This header specifies the media type of the resource. |

## Body Parameters

| Parameter | Description | Data Type | Required |
| --- | --- | --- | --- |
| phone_number | User's phone number in **E.164 format** (e.g., +6598765432) | String | Yes |

The phone number validation system detects issues such as redundant country codes or incorrect formats and accepts only valid numbers. All phone numbers are automatically standardized to the correct format, whether uploaded with or without a country code.

## Sample Request

The sample below displays a request to unsubscribe a user from WhatsApp communications.

Every request to the request endpoint requires **a JSON-formatted** request body containing your phone number’s content and metadata, including the subscriber’s phone number.

```bash
curl --location --request POST 'https://contact.useinsider.com/whatsapp/v1/unsubscribe' \
--header 'Content-Type: application/json' \
--header 'X-PARTNER-NAME: mybrand' \
--header 'X-REQUEST-TOKEN: a1b2c3d4e5f6' \
--data-raw '{
    "phone_number": "+905012345678"
}'
```

## Sample Responses

The following are some sample responses you might receive for your request.

#### 200 OK

```json
{
  "statusMessage": "OK"
}
```

#### 400 Bad Request

```json
{
  "statusMessage": "Bad request"
}
```

#### 401 Unauthorized

```json
{
  "statusMessage": "Unauthorized"
}
```

## Limitations

- All functions must be executed with a simple **HTTPS POST** request.
- Only global unsubscribers can be sent via this API. No data can be retrieved.
- The API Key should be provided as the authorization key in the request header. If the key is incorrect, the operation will not be executed, and an authorization error will return in the response.
- The value of the X-PARTNER-NAME header should be **lowercase**.

## Related

- [API Rate Limits](/api-rate-limits.md)
- [Resubscribe WhatsApp Users V1](/resubscribe-whatsapp-users-v1.md)
- [Insider One APIs in Postman](/insider-apis-in-postman.md)
- [API Authentication Tokens](/api-authentication-tokens.md)
- [API Status and Error Codes](/api-status-and-error-codes.md)