---
schema_version: "1"
id: 892f4a4b8a4e3b2665112b50df3473c8188b1d9b322e55200f058ada8fcb871a
title: Salesforce Commerce Address Management API
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/commerce-cloud/salesforce-commerce/guides/d2c-commerce/b2b-d2c-comm-address-mgmt-apis.md
canonical_url: https://developer.salesforce.com/docs/commerce/salesforce-commerce/guide/b2b-d2c-comm-address-mgmt-apis.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 9c7f1ec018f2e526c4d71d374b045d0d5659c391ec1e2d9aae33a9d245bd5f74
products:
  - B2B Commerce Developer Guide
  - Salesforce APIs
---
# Salesforce Commerce Address Management API

Salesforce's Commerce Address Management APIs facilitate seamless handling of customer addresses within the platform. Integrating these APIs enhances the user experience by allowing customers to effortlessly manage their addresses, which is essential for smooth checkout and delivery processes.

Registered users can quickly manage their addresses on the My Profile page. The Webstore Account Addresses API allows a user to add a new address to their account associated with a webstore. With support for both POST and GET methods, this API enables users to enter new addresses as well as obtain and show their current address information on the account page. You can also update an address that is already in use or remove an address that is no longer needed by using the Webstore Account Address API. Both the PATCH and DELETE methods are also supported by this API.

## Use Case

Let's consider a scenario where a customer wants to manage their shipping addresses within their account.

![Diagram of the address management API workflow for B2B and D2C Commerce](https://developer.salesforce.com/media/d2c-commerce/address_mgmt_api_workflow.png '{"class": "image-lg", "title": "Checkout Workflow"}')

The authenticated customer logs in and goes to the My Profile page, which displays the user account information, including any saved addresses. A GET request to the [Webstore Account Addresses API](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_commerce_webstore_accounts_addresses.htm) fetches and displays a list of the customer's saved addresses. When the customer creates a new address, a POST request is made to the [Webstore Account Addresses API](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_commerce_webstore_accounts_addresses.htm). If an existing address needs correction, the customer makes the necessary changes and saves them, triggering a PATCH request to the [Webstore Account Address API](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_commerce_webstore_accounts_addresses_address.htm). Finally, the user can remove an address by making a DELETE request to the [Webstore Account Address API](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_commerce_webstore_accounts_addresses_address.htm).

## Resources

Here’s a list of Commerce Address Management resources:

| Resource                                                                                                                                                                                                                        | Supported HTTP Methods | Description                                                                                                     |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | --------------------------------------------------------------------------------------------------------------- |
| [`/commerce/webstores/{webstoreId}/accounts​/accountId/addresses`](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_commerce_webstore_accounts_addresses.htm)                     | GET, POST              | Create a Commerce account address for a webstore, or retrieve a collection of addresses for a webstore account. |
| [`/commerce/webstores/{webstoreId}/accounts​/accountId/addresses/{addressId}`](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_commerce_webstore_accounts_addresses_address.htm) | DELETE, PATCH          | Update or delete an address for a Commerce account associated with a webstore.                                  |