---
title: remove
slug: campaign/docs/remove-http-api
docTags: 
createdAt: 2026-07-02T19:01:46.737Z
---

:::hint{type="success"}
**Tip**
This operation does not unsubscribe a recipient. To do that, use the [unsubscribe](https://world.optimizely.com/documentation/developer-guides/campaign/http-api/services-and-operations/unsubscribe/) operation.
:::

This operation is available in the mail and the form service.

**Parameters**

| Name          | Mandatory | Default value | Description                                                                                                                                                                                                        |
| ------------- | --------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| bmRecipientId | yes/no    | –             | The ID of the new recipient (usually the email address). If used in the mail service, this parameter is not mandatory (the email address is sent anyway). If used in the form service, the parameter is mandatory. |

**Return values**

| Value          | Description                                                                                                                                                                                                                                                                                                                                                    |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ok             | Recipient successfully removed from the recipient list                                                                                                                                                                                                                                                                                                         |
| ok: not\_found | Only with **bmVerbose=true**: The recipient could not be found in the recipient list.                                                                                                                                                                                                                                                                          |
| wrong\_tag     | Authorization failed.<br />Error codes:<br />- 501=wrong authentication tag<br />- 502=wrong request IP<br />- 503=wrong request method<br />- 504=wrong protocol<br />- 505=wrong recipient list<br />- 506=wrong action<br />- 507=action not found<br />If a verification of the authentication tag does not solve the problem, contact *customer support*. |
| missing\_id    | When using the form service: No **bmRecipientId** was transmitted.                                                                                                                                                                                                                                                                                             |
| system\_error  | A general error occurred.                                                                                                                                                                                                                                                                                                                                      |

**Example 1**

```javascript
.../form/.../remove?bmRecipientId=john.smith%40example.com
```

The recipient with the ID [\_john.smith@example.com\_](#) is removed from the recipient list. This recipient list is identified by the authorization code.

**Example 2**

```javascript
.../mail/.../remove?bmUrl=http://www.example.com
```

The recipient of the email is removed from the recipient list to which the mailing was sent. Then, the recipient is forwarded to [www.example.com](http://www.example.com).