> 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

# UpdateAddressBookItem

Updates and inserts all the specified items passed to your address book. This method returns an UpdateAddressBookResult object.

## Schema

![UpdateAddressBookItems](/_fern-files/_img/014d7e342f7473ed86d06c916b52a1490e2046e6a09f1bb50c7670b7ceab1465.webp)

| Name              | Schema Type           | Description                                                                       |
| ----------------- | --------------------- | --------------------------------------------------------------------------------- |
| AddressBookItems  | AddressBookItem Array | Array of address book items to update or insert.                                  |
| ReturnAddressBook | Boolean               | If true, return the address book item list in the UpdateAddressBookResult object. |

## UpdateAddressBookResult

![UpdateAddressBookResult](/_fern-files/_img/624ccf9d0c42fb439f8384d49bf3b0a23954310979b9e25037adcffd7c86ac33.webp)

| Name             | Schema Type           | Description                                                                                                                           |
| ---------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Success          | Boolean               | True if successful.                                                                                                                   |
| AddressBookItems | AddressBookItem Array | Array of AddressBookItem after the updates are completed. The AddressBookItem object is described in the GetAddressBookItems section. |

## Rules and exceptions for UpdateAddressBookItems

* 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.
* If the address book ID is left blank in the AddressBookItem object a new address book entry will be added.
* If the AddressBookItem share is changed and the user does not have address book sharing privileges, the address book item share will not be updated.
* AddressBook_Email_Invalid – if there is an invalid email in the address book items passed to the API this error will be returned and no updates will be done.