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.
Creates a new subscription for the specified notification type and destination.
The CreateSubscription operation indicates that the specified notification type should be delivered to the specified Destination. Before you can subscribe, you must first register the Destination by calling the RegisterDestination operation.
For more information about the notifications that you can subscribe to, see NotificationType enumeration.
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 | Specifies the NotificationType, Destination, and other parameters for notifications that you want to subscribe to. | Yes | Type: Subscription |
The CreateSubscription 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=CreateSubscription &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%3A36%3A10Z &Version=2013-07-01 &Signature=IUc%2EXAMPLEQajCIZLP8DHXxdl%2FXupCJ6f51bD%2BMEEU%2F%2Bc%3D
For information about standard response formatting, see Response format.
<CreateSubscriptionResponse xmlns="http://mws.amazonservices.com/schema/Subscriptions/2013-07-01"> <CreateSubscriptionResult/> <ResponseMetadata> <RequestId>c9bb2e77-2425-4e1a-9c85-36d00EXAMPLE</RequestId> </ResponseMetadata> </CreateSubscriptionResponse>