# Updating the subscription's shipping address

Managing the shipping address for a subscription is a straightforward process, allowing you to ensure your products always reach the right destination. Whether you need to update the address due to a customer's move or correct a previous error, our API makes it easy to modify the shipping details. Follow the intructions below to update the shipping address of any subscription with a simple API call.

Managing shipping addresses accurately is crucial for several reasons:

* **Customer satisfaction**: Ensuring that products are delivered to the right address on time increases customer satisfaction and loyalty.
* **Reduced costs**: Correct addresses help avoid extra shipping costs associated with returns and reshipments.
* **Efficiency**: Streamlining the shipping process with accurate addresses improves operational efficiency and turnover time.
* **Reputation**: Consistently accurate deliveries bolster a company's reputation for reliability and efficiency.
* **Compliance**: Accurate shipping information is also a legal or regulatory requirement in certain industries and regions.

By maintaining up-to-date and precise shipping addresses, companies can streamline their logistics, reduce operational costs, and provide better customer service.

To manage a subscription's shipping address, use the [`POST /v1/subscriptions/{subscriptionId}/ship-to-address`](https://docs.digitalriver.com/commerce-api-references/admin-apis/subscription-mangement/manage-the-subscriptions-address#v1-subscriptions-subid-ship-to-address) request. Replace `{subscriptionId}` with the actual subscription identifier, `{Your_Access_Token}` with your authorization key, and send a JSON payload with the new address details.

{% tabs %}
{% tab title="cURL" %}

```javascript
curl --location --request POST 'https://{host}/v1/subscriptions/{subscriptionId}/ship-to-address' \
--header 'Authorization: Basic {Your_Access_Token}' \
...
--data-raw '{
    "firstName": "Jane", 
    "lastName": "Doe", 
    "companyName": "Acme Company", 
    "line1": "1234 Fake Street",
    "line2": "Apt. 2", 
    "line3": null, 
    "city": "Minnetonka",
    "countrySubdivision": "MN", 
    "postalCode": "55343", 
    "country": "US", 
    "phoneNumber": "555-253-1234", 
    "countyName" : null, 
    "emailAddress": "jdoe@acme.com" 
}'
```

{% endtab %}
{% endtabs %}

After successfully updating the address, you will receive a `202 Accepted` response. The new plan will go into effect immediately.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digitalriver.com/commerce-api/shopper-apis/subscriptions/immediately-change-the-subscription/updating-the-subscriptions-shipping-address.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.