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.
Specifies a new destination where you want to receive notifications.
The RegisterDestination operation specifies a location where you want to receive notifications and adds it to the list of registered destinations. For more information on what kinds of destinations can be specified, see Receiving notifications.
After you register a Destination, you must create a Subscription by calling the CreateSubscription operation to begin receiving notifications.
To remove a Destination that you have registered from the list of registered destinations, call the DeregisterDestination operation.
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 |
Destination | The Destination where you want to receive notifications. | Yes | Type: Destination |
The RegisterDestination 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=AKIAEEXAMPLESA &Action=RegisterDestination &Destination.AttributeList.member.1.Key=sqsQueueUrl &Destination.AttributeList.member.1.Value= https%3A%2F%2Fsqs.us-east-1.amazonaws.com%2F51471EXAMPLE%2Fmws_notifications &Destination.DeliveryChannel=SQS &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &MarketplaceId=ATVPDKIKX0DER &SellerId=A135KEXAMPLE56 &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp=2013-07-25T16%3A14%3A01Z &Version=2013-07-01 &Signature=WgTRuEXAMPLEeIzoJ5tzX06uKV7ongzUserZ6vj8kug%3D
For information about standard response formatting, see Response format.
<RegisterDestinationResponse xmlns="http://mws.amazonservices.com/schema/Subscriptions/2013-07-01"> <RegisterDestinationResult/> <ResponseMetadata> <RequestId>b120e610-9cf0-48d7-b615-ca869EXAMPLE</RequestId> </ResponseMetadata> </RegisterDestinationResponse>