Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.
Updates the subscription for the specified notification type and destination.
The UpdateSubscription operation changes the properties of a Subscription that you previously created. If you no longer want to receive a particular notification type at a Destination, call either the DeleteSubscription operation or the UpdateSubscription operation with the IsEnabled request parameter set to false.
This operation is available in all marketplaces except Mexico.
Maximum request quota | Restore rate | Hourly request quota |
---|---|---|
25 requests | Two requests every second | 7200 requests per hour |
For more information about the request parameters that are required for all Amazon MWS operations, see Required request parameters in the Amazon MWS Developer Guide.
Name | Description | Required | Valid values |
---|---|---|---|
MarketplaceId | The unique identifier for the marketplace. | Yes | Any valid MarketplaceId that you are registered in. For a list of MarketplaceId
values, see Amazon MWS endpoints and MarketplaceId values in the Amazon MWS Developer Guide. Type: xs:string |
Subscription | The subscription to update. All child elements except the NotificationType and Destination can be changed. | Yes | Any valid Subscription that you previously created by
calling the CreateSubscription operation. Type: Subscription |
The UpdateSubscription operation only returns the common response elements.
For information about standard request requirements, see Required request parameters.
POST /Subscriptions/2013-07-01 HTTP/1.1 Content-Type: x-www-form-urlencoded Host: mws.amazonservices.com User-Agent: <Your User Agent Header> AWSAccessKeyId=AKIAEEXAMPLENGQCJLSA &Action=UpdateSubscription &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &MarketplaceId=ATVPDKIKX0DER &SellerId=A135KEXAMPLE56 &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Subscription.Destination.AttributeList.member.1.Key=sqsQueueUrl &Subscription.Destination.AttributeList.member.1.Value= https%3A%2F%2Fsqs.us-east-1.amazonaws.com%2F51471EXAMPLE%2Fmws_notifications &Subscription.Destination.DeliveryChannel=SQS &Subscription.IsEnabled=true &Subscription.NotificationType=AnyOfferChanged &Timestamp=2013-07-25T16%3A45%3A11Z &Version=2013-07-01 &Signature=eEfk%EXAMPLE8FKMWt411Ac%2FLmiwQW%2B7CFnIVl8ZWdIFI%3D
For information about standard response formatting, see Response format.
<UpdateSubscriptionResponse xmlns="http://mws.amazonservices.com/schema/Subscriptions/2013-07-01"> <UpdateSubscriptionResult/> <ResponseMetadata> <RequestId>3263ad38-d15b-4043-b48c-cbfa2EXAMPLE</RequestId> </ResponseMetadata> </UpdateSubscriptionResponse>