# BMManageButtonStatus API Operation (NVP) (/api/nvp-soap/manage-button-status-nvp)



Changes the status of a hosted button.

> **Note:** **Important:**
>
> The Button Manager API is deprecated. For new integrations, see the associated topic.
>
> | Button                                          | See                                                                               |
> | ----------------------------------------------- | --------------------------------------------------------------------------------- |
> | **Buy Now**<br />                               | [PayPal Checkout Overview](/checkout)<br />                                       |
> | **Add to Cart**<br />                           | [Solution Providers](https://www.paypal.com/webapps/mpp/solution-providers)<br /> |
> | **Donate**<br />                                | [Create a Donate button](/api/nvp-soap/paypal-payments-pro)<br />                 |
> | **Automatic Billing**<br /> **Subscribe**<br /> | [Subscriptions Overview](/subscriptions/about)<br />                              |

Currently, you can only delete a button.

## BMManageButtonStatus request [#bmmanagebuttonstatus-request]

The request specifies the hosted button's ID and the status you want to set the button to.

### BMManageButtonStatus request parameters [#bmmanagebuttonstatus-request-parameters]

| Field<br />            | Description<br />                                                                                                   |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------- |
| `METHOD`<br />         | *(Required)* `BMManageButtonStatus`<br />                                                                           |
| `HOSTEDBUTTONID`<br /> | *(Required)* The ID of the hosted button whose status you want to change.<br />                                     |
| `BUTTONSTATUS`<br />   | *(Required)* The new status of the button. Value is:<br /> <br />`DELETE`. The button is deleted from PayPal.<br /> |

## BMManageButtonStatus response [#bmmanagebuttonstatus-response]

The response does not include any fields that are specific to the `BMManageButtonStatus` API operation.

## BMManageButtonStatus errors [#bmmanagebuttonstatus-errors]

| Error code | Short and long messages                                                                                                         | User action                                                                                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 10001      | Internal Error<br />Internal Error                                                                                              | To learn more about possible causes and corrective actions, see [What is API error code 10001?](https://www.paypal.com/selfhelp/article/what-is-api-error-code-10001-ts1041/3?channel=MTS). |
| 11950      | Invalid Data<br />A hosted button ID must be specified.                                                                         |                                                                                                                                                                                             |
| 11951      | Invalid Argument<br />The hosted button ID specified is invalid.                                                                |                                                                                                                                                                                             |
| 11951      | Invalid Argument<br />The hosted button ID specified is invalid.                                                                |                                                                                                                                                                                             |
| 11992      | Invalid Argument<br />You do not have permissions to access this button. Verify the hosted button ID and try the request again. |                                                                                                                                                                                             |
| 11993      | Invalid Argument<br />The button status value specified is not valid.                                                           |                                                                                                                                                                                             |