# Updating a subscription's billing and shipping email address

Updating a subscription's billing and shipping email address is critical in ensuring that the shopper stays informed about their subscription details and receives all necessary communications. Whether it's a notification for a billing statement, shipping update, or any other important information, having the correct email address is vital. This guide will walk you through the simple steps to update a shopper's subscription billing and shipping email address using a POST request. Follow the instructions below to keep your subscription information up-to-date.

Updating the email addresses for subscriptions is crucial for several reasons:

* **Ensures effective communication:** It guarantees that the shopper receives all essential notifications related to billing statements, shipping updates, or any other critical information about their subscription.
* **Avoids service interruptions:** Keeping the email address updated helps prevent missed communications that could lead to service disruptions, such as failure to renew due to missed payment reminders.
* **Enhances customer experience:** It ensures that customers are well-informed about their subscription status and any changes, promoting transparency and trust.
* **Facilitates account management:** Updated contact information makes it easier for customers to manage their subscriptions and for businesses to provide timely support.

Therefore, maintaining current email addresses is vital for the customer's convenience and the business’s operational efficiency.

Send a [`POST /v1/subscriptions/{subscriptionId}/email`](https://docs.digitalriver.com/commerce-api-references/admin-apis/subscription-mangement/update-a-subscriptions-email-address#v1-subscriptions-subscriptionid-email) request to the subscription's specific endpoint to update the subscription's billing and shipping email address. Here's how you can do it using `curl`:

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

```javascript
curl --location --request POST 'https://api.digitalriver.com/v1/subscriptions/{subscriptionId}/email' \
--header 'Authorization: Basic  {Your_Access_Token}' \
...
--data-raw '{
  "emailAddress": "string"
}'
```

{% endtab %}
{% endtabs %}

Replace `{subscriptionId}` with the actual ID of the subscription you want to update and `{Your_Access_Token}` with your authorization key. Refer to the [Obtain API credentials](/commerce-api/master.md#step-1-obtain-api-credentials) topic for more information on your authorization key. Set `"your_email@example.com"` to the new email address you wish to use.

Upon success, you will receive a `200 Accepted` response. See the [Error codes for shopper APIs](https://docs.digitalriver.com/commerce-api-references/warnings-and-error-codes/error-codes/error-codes-for-shopper-apis) section if you get an error. 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/admin-apis/subscription-management/immediately-change-the-subscription/updating-a-subscriptions-billing-and-shipping-email-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.