> You are reading the Docusign Developer Documentation. For clean Markdown of any page, append .md to the page URL.
>
> Documentation indexes by section:
> - APIs and SDKs: https://docusign.docs.buildwithfern.com/docs/llms.txt
> - Platform 101: https://docusign.docs.buildwithfern.com/platform/llms.txt
> - Extension Apps: https://docusign.docs.buildwithfern.com/extension-apps/llms.txt
> - Docusign CLI: https://docusign.docs.buildwithfern.com/docusign-cli/llms.txt
>
> Authentication (OAuth, JWT Grant, M2M): https://docusign.docs.buildwithfern.com/platform/auth
> Webhooks and Connect: https://docusign.docs.buildwithfern.com/platform/webhooks
>
> OpenAPI specifications: https://docusign.docs.buildwithfern.com/openapi.json
> MCP server: https://docusign.docs.buildwithfern.com/_mcp/server

# RemoveAddressBookItems

### Schema

![RemoveAddressBookItems](/_fern-files/_img/55c410eba96e84b900e4d51d96968030e2fafd2987fc47214e0dcc51391a5a84.webp)

**`C#`**

```csharp title="C#"
// Grab all the address book items from the specified account
DocuSignWeb.AddressBookItem[] items = _apiClient.GetAddressBookItems(_accountId);

if(items.Length >= 1)
{
    // Use the address book ID of an item to remove it
    DocuSignWeb.AddressBookRemoveItem toRemove = new DocuSignWeb.AddressBookRemoveItem();
    toRemove.AddressBookID = items[0].AddressBookID;

    // Construct an array with all the items you want to remove
    DocuSignWeb.AddressBookRemoveItem[] remove = { toRemove };
    DocuSignWeb.UpdateAddressBookResult result = _apiClient.RemoveAddressBookItems(remove,
        false);

    // Confirm that the removal succeeded
    Console.WriteLine("Removed item {0} succeeded? {1}", toRemove.AddressBookID,
        result.Success);
}
```

**`PHP`**

```php title="PHP"
// Grab all the address book items from the specified account
$getAddressBookItemsparams = new GetAddressBookItems();
$getAddressBookItemsparams->AccountID = $AccountID;
$addBookItems = $api->GetAddressBookItems($getAddressBookItemsparams)->GetAddressBookItemsResult->AddressBookItem;

if (count($addBookItems) >= 1) {
    $addToRemove = new AddressBookRemoveItem();
    // Build an array of the first address book item to remove
    $addToRemove->AddressBookID = $addBookItems[0]->AddressBookID;
    $removeAddressBookItemsparams = new RemoveAddressBookItems();
    $removeAddressBookItemsparams->AddressBookRemoveItems = array($addToRemove);
    $removeAddressBookItemsparams->ReturnAddressBook = false;
    $response = $api->RemoveAddressBookItems($removeAddressBookItemsparams);
}
else {
    $response = "No address book items to remove.";
}
```

| Name                   | Schema Type                 | Description                                                                       |
| ---------------------- | --------------------------- | --------------------------------------------------------------------------------- |
| AddressBookRemoveItems | AddressBookRemoveItem Array | Array of address book item IDs to remove.                                         |
| ReturnAddressBook      | Boolean                     | If true, return the address book item list in the UpdateAddressBookResult object. |

Removes all the specified items passed from your address book. This method returns an UpdateAddressBookResult object described earlier.

## AddressBookRemoveItem

### Schema

![AddressBookRemoveItem](/_fern-files/_img/5bac31f4467b291845968639c19a9e46a2b1bdb0abcb888bae2261c40058f5eb.webp)

| Name          | Schema Type | Description                |
| ------------- | ----------- | -------------------------- |
| AddressBookID | DSXId       | Address book ID to remove. |

## Rules and exceptions for RemoveAddressBookItems

* Account_Lacks_Permissions – account does not have permissions to use this API.
* User_Lacks_Permissions – user does not have permissions to use this API.
* Address book items that are passed to this API that the user does not own will not be removed.
* Invalid address book IDs will be ignored.