Skip to main content

Amazon Seller Central Component

Manage product listings, orders, inventory, and fulfillment in Amazon Seller Central.

Component key: amazon-seller-central ·
· Changelog ↓

Description​

Amazon Seller Central is Amazon's platform for managing third-party seller businesses on the Amazon marketplace. This component allows you to retrieve and update product listings, process orders, manage inventory, and handle fulfillment information.

API Documentation​

This component was built using the Amazon Selling Partner API.

Connections​

OAuth 2.0 Client Credentials​

key: clientCredentials
InputNotesExample
Authorize URL

The OAuth 2.0 Authorization URL for Amazon Seller Central. For the {Seller Central URL} use one of the Seller Central URLs. Replace {YOUR_APPLICATION_ID} with the application ID you received from the Developer Central page. If your app is still not in production, add the version=beta parameter to the URL.

{Seller Central URL}/apps/authorize/consent?application_id={YOUR_APPLICATION_ID}
Client ID

Client ID from your Amazon Seller Central application. Find this on the Developer Central page.

amzn1.application-oa2-client.1234567890abcdef
Client Secret

Client Secret from your Amazon Seller Central application. Find this on the Developer Central page.

Is Sandbox Environment

When set to Yes, the connection will use the Amazon SP-API sandbox environment for testing. Leave blank or select No for production use.

SP-API Endpoint

Selling Partner API endpoints are associated with a particular AWS Region. The AWS Region is important because it is part of the credential scope, which is required for calculating a signature when calling the Selling Partner API. Learn more

sellingpartnerapi-na.amazon.com
Scopes

Space-delimited set of one or more scopes to get the user's permission to access.

sellingpartnerapi::migration
Token URL

The OAuth 2.0 Token URL for Amazon Seller Central.

https://api.amazon.com/auth/o2/token

OAuth 2.0​

key: oauth2

To connect to Amazon Seller Central, register an application in the Developer Central console and configure OAuth 2.0 authentication.

For detailed information, refer to the Amazon Selling Partner API documentation.

Prerequisites​

Setup Steps​

To register the application for public or private seller use:

  1. Sign into Seller Central using developer credentials and navigate to Developer Central.
  2. On the Developer Central page, select Add new app client.
  3. Enter the OAuth Redirect URI: https://oauth2.prismatic.io/callback
  4. Save the application configuration.
  5. View the LWA Credentials section to access the Client ID and Client Secret.

Configure the Connection​

  • Enter the Client ID and Client Secret from the LWA Credentials section
  • Select the appropriate Region for the Seller Central account
  • Configure the Authorize URL based on the Seller Central region:
    • For the Seller Central URL, refer to Amazon's region URLs
    • Replace {YOUR_APPLICATION_ID} with the application ID from the Developer Central page
    • For applications not yet in production, add version=beta to the URL parameter
  • If connecting to a Sandbox environment, select Yes for the Is Sandbox Environment field

For information on required scopes and permissions, refer to the SP-API authorization documentation.

Public Developer Registration​

Amazon requires apps that will be used across multiple seller accounts to complete a public developer registration and Appstore listing review. This process verifies the integration complies with Amazon's data access policies before it can access seller accounts beyond the developer's own.

Complete public developer registration before deploying to end users. By default, an Amazon Seller Central app can only be authorized by the seller account that registered the application. Other sellers receive an error when attempting to connect. To allow other sellers to authorize the integration, the application must be registered as a public developer and listed on the Selling Partner Appstore.

Registering as a Public Developer​

  1. In the Developer Central console, navigate to Developer Profile
  2. Complete the developer registration questionnaire, including a description of the integration, data access justification for each requested permission, and security and data handling practices
  3. Submit the profile for Amazon's review. Registration review typically takes 1–2 weeks

For detailed requirements, refer to Registering your application.

Listing on the Selling Partner Appstore​

After public developer registration is approved, list the application on the Selling Partner Appstore so other sellers can install it:

  1. In Developer Central, navigate to the application and select Add Appstore listing
  2. Complete the listing details: title, description, screenshots, and support contact
  3. Submit the listing for review. Listing review adds approximately 1–2 additional weeks

For detailed requirements, refer to Listing your app on the Selling Partner Appstore.

Once the Appstore listing is approved, the version=beta parameter can be removed from the Authorize URL, indicating the application is no longer in draft state.

Self-Authorization (Private Use)

If the integration is only used to access the developer's own Seller Central account, public developer registration and Appstore listing are not required. The version=beta parameter should remain in the Authorize URL for self-authorization scenarios.

Amazon Seller Central Sandbox Environment

When connecting to the Sandbox environment, some fields require different value formats than Production to succeed. The expected values can be referenced in the Selling Partner API Models.

Orders Example (Model Reference):

  • Created After: TEST_CASE_200 or TEST_CASE_200_NEXT_TOKEN
  • Created Before: TEST_CASE_200 or TEST_CASE_200_NEXT_TOKEN
  • Order ID: TEST_CASE_200

Notifications Example (Model Reference):

  • Subscription ID: TEST_CASE_200_SUBSCRIPTION_ID
  • Created Before: TEST_CASE_200_DESTINATION_ID
InputNotesExample
Authorize URL

The OAuth 2.0 Authorization URL for Amazon Seller Central. For the {Seller Central URL} use one of the Seller Central URLs. Replace {YOUR_APPLICATION_ID} with the application ID you received from the Developer Central page. If your app is still not in production, add the version=beta parameter to the URL.

{Seller Central URL}/apps/authorize/consent?application_id={YOUR_APPLICATION_ID}
Client ID

Client ID from your Amazon Seller Central application. Find this on the Developer Central page.

amzn1.application-oa2-client.1234567890abcdef
Client Secret

Client Secret from your Amazon Seller Central application. Find this on the Developer Central page.

Is Sandbox Environment

When set to Yes, the connection will use the Amazon SP-API sandbox environment for testing. Leave blank or select No for production use.

SP-API Endpoint

Selling Partner API endpoints are associated with a particular AWS Region. The AWS Region is important because it is part of the credential scope, which is required for calculating a signature when calling the Selling Partner API. Learn more

sellingpartnerapi-na.amazon.com
Scopes

Space-delimited set of one or more scopes to get the user's permission to access.

Token URL

The OAuth 2.0 Token URL for Amazon Seller Central.

https://api.amazon.com/auth/o2/token

Triggers​

New and Updated Records​

Checks for new and updated orders or feeds in Amazon Seller Central on a configured schedule. | key: pollChangesTrigger

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Marketplace Ids

List of MarketplaceId values. Used to select orders that were placed in the specified marketplaces. See the Marketplace IDs documentation for a complete list of marketplaceId values.

Resource Type

The type of resource to poll for new and updated records.

Show New Records

Include newly created records in trigger results.

true
Show Updated Records

Include updated records in trigger results.

true

This trigger polls the Amazon Selling Partner API for new and updated records across a selected resource type on a configured schedule.

How It Works​

  1. The trigger runs on the configured schedule (e.g., every 5 minutes)
  2. It fetches records from the selected Amazon Seller Central resource, optionally filtered by marketplace
  3. Records are categorized as created or updated based on timestamp fields, compared against the last successful poll time
  4. The trigger updates its internal state after each poll, storing the poll timestamp for use in the next execution

Configuration​

Configure the following inputs:

  • Connection: The Amazon Seller Central connection used to authenticate API requests

  • Resource Type: The Amazon Seller Central resource to monitor. Available options:

    ResourceChange DetectionTracks NewTracks Updated
    OrdersTimestamp (PurchaseDate)YesYes
    FeedsTimestamp (submission date)YesNo

  • Marketplace IDs: An optional list of marketplace IDs used to filter Orders results to specific Amazon marketplaces. When left empty, orders across all accessible marketplaces are returned. Does not apply to Feeds

  • Show New Records: When enabled, includes newly created records in the results. Defaults to true

  • Show Updated Records: When enabled, includes modified records in the results. Applies only to Orders. Defaults to true

Returned Data​

The trigger returns an object with two arrays — created for new records and updated for modified records. For Feeds, updated is always an empty array.

Example Response
{
  "data": {
    "created": [
      {
        "AmazonOrderId": "111-1234567-1234567",
        "PurchaseDate": "2024-01-15T10:30:00Z",
        "OrderStatus": "Pending",
        "MarketplaceId": "ATVPDKIKX0DER"
      }
    ],
    "updated": [
      {
        "AmazonOrderId": "111-9876543-9876543",
        "PurchaseDate": "2024-01-10T09:00:00Z",
        "OrderStatus": "Shipped",
        "MarketplaceId": "ATVPDKIKX0DER"
      }
    ]
  }
}

Notes​

  • Orders use PurchaseDate for both new and updated detection — an order is classified as created if its PurchaseDate exceeds the last poll time; updated orders (status changes, shipment updates) are detected via a separate LastUpdateDate field
  • Feeds do not expose an update timestamp, so only newly submitted feeds are tracked
  • Marketplace ID filtering applies only to Orders; specifying marketplace IDs when monitoring Feeds has no effect

Data Sources​

Select AWS Region​

Select an AWS region | key: selectRegion | type: picklist

Select Destinations​

Select a destination from your Amazon Seller Central account | key: selectDestinations | type: picklist

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Example Payload for Select Destinations⤓
Loading…

Select Feed​

Select a feed from your Amazon Seller Central account | key: selectFeed | type: picklist

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Created Since

The earliest feed creation date and time for feeds included in the response in ISO 8601 format. The default is 90 days ago. Feeds are retained for a maximum of 90 days.

2024-01-01T00:00:00.000Z
Created Until

The latest feed creation date and time for feeds included in the response in ISO 8601 format. The default is now.

2024-12-31T23:59:59.999Z
Feed Types

List of feed types used to filter feeds. When feedTypes is provided, the other filter parameters (processingStatuses, marketplaceIds, createdSince, createdUntil) and pageSize may also be provided. <strong>Important:</strong> Either feedTypes or nextToken is required.

POST_PRODUCT_DATA
Marketplace Ids

List of MarketplaceId values. Used to select orders that were placed in the specified marketplaces. See the Marketplace IDs documentation for a complete list of marketplaceId values.

Processing Statuses

List of processing statuses used to filter feeds.

Example Payload for Select Feed⤓
Loading…

Select Order​

Select an order from your Amazon Seller Central account | key: selectOrder | type: picklist

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Created After

Date used for selecting orders created after (or at) a specified time in ISO 8601 format. Only orders placed after the specified time are returned. Either the CreatedAfter parameter or the LastUpdatedAfter parameter is required.

2024-01-15T10:30:00.000Z
Created Before

Date used for selecting orders created before (or at) a specified time in ISO 8601 format. Only orders placed before the specified time are returned.

2024-12-31T23:59:59.999Z
Last Updated After

Date used for selecting orders that were last updated after (or at) a specified time in ISO 8601 format. An update is defined as any change in order status, including the creation of a new order. Includes updates made by Amazon and by the seller.

2024-01-15T10:30:00.000Z
Last Updated Before

Date used for selecting orders that were last updated before (or at) a specified time in ISO 8601 format. An update is defined as any change in order status, including the creation of a new order. Includes updates made by Amazon and by the seller.

2024-12-31T23:59:59.999Z
Marketplace Ids

List of MarketplaceId values. Used to select orders that were placed in the specified marketplaces. See the Marketplace IDs documentation for a complete list of marketplaceId values.

Example Payload for Select Order⤓
Loading…

Select Subscription​

Select a subscription from your Amazon Seller Central account. | key: selectSubscription | type: picklist

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Notification Type

The type of notification. See the Notifications API documentation for available notification types.

Example Payload for Select Subscription⤓
Loading…

Actions​

Cancel Feed​

Cancels the feed that you specify. | key: cancelFeed

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Feed Id

The identifier for the feed. This identifier is unique only in combination with a seller ID.

50017017797
Example Payload for Cancel Feed⤓
Loading…

Cancel Shipment​

Cancel the shipment indicated by the specified shipment identifier. | key: cancelShipment

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Shipment Id

The Amazon-defined shipment identifier for the shipment to cancel.

6f77095e-9f75-47eb-aaab-a42d5428fa1a
Example Payload for Cancel Shipment⤓
Loading…

Confirm Order Shipment​

Updates the shipment confirmation status for a specified order. | key: confirmOrderShipment

InputNotesExample
Carrier Code

Identifies the carrier that will deliver the package.

USPS
Carrier Name

Carrier name that will deliver the package. <strong>Important:</strong> Required when carrierCode is 'Others'.

Amazon Logistics
COD Collection Method

The COD collection method. Supported in Japan marketplace only.

Connection

The Amazon Seller Central connection to use.

Marketplace Id

The marketplace identifier. See the Marketplace IDs documentation for available marketplaces.

ATVPDKIKX0DER
Order Id

An Amazon-defined order identifier in 3-7-7 format.

123-1234567-1234567
Order Items

The list of order items and quantities to be updated.

[
  {
    "orderItemId": "79039765272157",
    "quantity": 1,
    "transparencyCodes": [
      "09876543211234567890"
    ]
  }
]
Package Reference Id

A seller-supplied identifier that uniquely identifies a package within the scope of an order. Only positive numeric values are supported.

12345
Ship Date

The shipping date for the package in ISO 8601 date/time format.

2024-03-15T14:30:00.000Z
Ship From Supply Source Id

The unique identifier of the supply source.

SUPPLY-12345
Shipping Method

Ship method to be used for shipping the order.

Standard
Tracking Number

The tracking number used to obtain tracking and delivery information.

1Z999AA10123456784
Example Payload for Confirm Order Shipment⤓
Loading…

Create Destination​

Creates a destination resource to receive notifications. | key: createDestination

InputNotesExample
Account Id

The identifier for the AWS account that is responsible for charges related to receiving notifications.

123456789012
ARN

The Amazon Resource Name (ARN) associated with the SQS queue.

arn:aws:sqs:us-east-1:123456789012:my-notification-queue
Connection

The Amazon Seller Central connection to use.

Name

A developer-defined name to help identify this destination.

MyNotificationDestination
AWS Region

AWS provides services in multiple regions, like us-west-2 or eu-west-1.

us-east-1
Example Payload for Create Destination⤓
Loading…

Create Feed​

Creates a feed. Upload the contents of the feed document before calling this operation. | key: createFeed

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Feed Options

Additional options to control the feed. These vary by feed type.

Feed Type

The feed type. See the Feeds API documentation for available feed types.

POST_PRODUCT_DATA
Input Feed Document Id

The document identifier returned by the createFeedDocument operation. Upload the feed document contents before calling the createFeed operation.

amzn1.tortuga.3.edbcd0d8-3434-8222-ac6f-bac123456789.T1URXX1LHU1Q
Marketplace Ids

List of MarketplaceId values. Used to select orders that were placed in the specified marketplaces. See the Marketplace IDs documentation for a complete list of marketplaceId values.

Example Payload for Create Feed⤓
Loading…

Create Feed Document​

Creates a feed document for the feed type that you specify. | key: createFeedDocument

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Content Type

The content type of the feed.

text/xml; charset=UTF-8
Example Payload for Create Feed Document⤓
Loading…

Create Listings Item​

Creates a new or fully-updates an existing listings item for a selling partner. | key: createListingsItem

InputNotesExample
Attributes

JSON object containing structured listings item attribute data keyed by attribute name.

{
  "condition_type": [
    {
      "value": "new_new",
      "marketplace_id": "ATVPDKIKX0DER"
    }
  ],
  "item_name": [
    {
      "value": "Example Product Name",
      "marketplace_id": "ATVPDKIKX0DER"
    }
  ]
}
Connection

The Amazon Seller Central connection to use.

Issue Locale

A locale for localization of issues. When not provided, the default language code of the first marketplace is used. Examples: 'en_US', 'fr_CA', 'fr_FR'. Localized messages default to 'en_US' when a localization is not available in the specified locale.

en_US
Marketplace Ids

List of MarketplaceId values. Used to select orders that were placed in the specified marketplaces. See the Marketplace IDs documentation for a complete list of marketplaceId values.

Product Type

The Amazon product type of the listings item.

LUGGAGE
Requirements

The name of the requirements set for the provided data.

Seller Id

A selling partner identifier, such as a seller account or vendor code. <strong>Important:</strong> Required when identifiersType is SKU.

A2EXAMPLE123456
Stock Keeping Unit (SKU)

A selling partner provided identifier for an Amazon listing.

MY-PRODUCT-SKU-001
Example Payload for Create Listings Item⤓
Loading…

Create Shipment​

Create a shipment with the information provided. | key: createShipment

InputNotesExample
Amazon Order Id

An Amazon-defined order identifier in 3-7-7 format.

123-1234567-1234567
Connection

The Amazon Seller Central connection to use.

Hazmat Type

Hazardous materials options for a package. Consult the terms and conditions for each carrier for more information about hazardous materials.

Include Packing Slip With Label

When true, include a packing slip with the label.

false
Item List

The list of items to be included in a shipment.

[
  {
    "orderItemId": "12345678901234",
    "quantity": 1,
    "ItemWeight": {
      "Value": 2.5,
      "Unit": "oz"
    },
    "ItemDescription": "Product Description",
    "TransparencyCodeList": [
      "AMZN1234567890"
    ],
    "ItemLevelSellerInputsList": [
      {
        "AdditionalInputFieldName": "CustomField",
        "AdditionalSellerInput": {
          "DataType": "String",
          "ValueAsString": "Custom Value"
        }
      }
    ]
  }
]
Label Customization

Label customization options.

{
  "CustomTextForLabel": "FRAGILE - HANDLE WITH CARE",
  "StandardIdForLabel": "AmazonOrderId"
}
Must Arrive By Date

The date by which the package must arrive to keep the promise to the customer in ISO 8601 datetime format. If MustArriveByDate is specified, only shipping service offers that can be delivered by that date are returned.

2024-03-20T23:59:59.999Z
Package Dimensions

The package dimensions.

{
  "Length": 12.5,
  "Width": 10,
  "Height": 8,
  "Unit": "inches",
  "PredefinedPackageDimensions": "FedEx_Box_10kg"
}
Seller Order Id

A seller-defined order identifier.

ORDER-12345
Ship Date

The shipping date for the package in ISO 8601 date/time format.

2024-03-15T14:30:00.000Z
Ship From Address

The address of the sender.

{
  "Name": "John Doe",
  "AddressLine1": "123 Main Street",
  "AddressLine2": "Suite 100",
  "AddressLine3": "",
  "DistrictOrCounty": "",
  "Email": "seller@example.com",
  "City": "Seattle",
  "StateOrProvinceCode": "WA",
  "PostalCode": "98101",
  "CountryCode": "US",
  "Phone": "206-555-0123"
}
Shipment Level Seller Inputs List

Additional seller-provided inputs for the shipment.

[
  {
    "AdditionalInputFieldName": "ShipmentNote",
    "AdditionalSellerInput": {
      "DataType": "String",
      "ValueAsString": "Rush delivery requested"
    }
  }
]
Shipping Service Id

An Amazon-defined shipping service identifier.

USPS-PTP-PRI
Shipping Service Offer Id

Identifies a shipping service order made by a carrier.

OFFER-12345
Shipping Service Options

Extra services offered by the carrier.

{
  "DeliveryExperience": "DeliveryConfirmationWithAdultSignature",
  "DeclaredValue": {
    "CurrencyCode": "USD",
    "Amount": 100
  },
  "CarrierWillPickUp": true,
  "CarrierWillPickUpOption": "ShipperWillDropOff",
  "LabelFormat": "ZPL203"
}
Weight

The package weight unit.

Example Payload for Create Shipment⤓
Loading…

Create Subscription​

Creates a subscription for the specified notification type to be delivered to the specified destination. | key: createSubscription

InputNotesExample
Aggregation Time Period

The supported aggregation time periods. For example, if FiveMinutes is the value chosen, and 50 price updates occur for an ASIN within 5 minutes, Amazon will send only two notifications; one for the first event, and then a subsequent notification 5 minutes later with the final end state of the data. The 48 interim events will be dropped.

Connection

The Amazon Seller Central connection to use.

Destination Id

The identifier for the destination where notifications will be delivered.

amzn1.sp-api.destination.12345678-90ab-cdef-1234-567890abcdef
Event Filter Type

An eventFilterType value that is supported by the specific notificationType. This is used by the subscription service to determine the type of event filter. Refer to the Notifications Use Case Guide for the specific notificationType to determine if an eventFilterType is supported.

Marketplace Ids

A list of marketplace identifiers to subscribe to (e.g. ATVPDKIKX0DER). To receive notifications in every marketplace, do not provide this list.

Notification Type

The type of notification. See the Notifications API documentation for available notification types.

Order Change Types

List of order change types to subscribe to (e.g. BuyerRequestedChange). To receive notifications of all change types, do not provide this list.

Payload Version

The version of the payload object to be used in the notification.

1.0
Example Payload for Create Subscription⤓
Loading…

Delete Destination​

Deletes the destination that you specify. | key: deleteDestination

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Destination Id

The identifier for the destination that you want to delete.

amzn1.sp-api.destination.12345678-90ab-cdef-1234-567890abcdef
Example Payload for Delete Destination⤓
Loading…

Delete Listings Item​

Delete a listings item for a selling partner. | key: deleteListingsItem

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Issue Locale

A locale for localization of issues. When not provided, the default language code of the first marketplace is used. Examples: 'en_US', 'fr_CA', 'fr_FR'. Localized messages default to 'en_US' when a localization is not available in the specified locale.

en_US
Marketplace Ids

List of MarketplaceId values. Used to select orders that were placed in the specified marketplaces. See the Marketplace IDs documentation for a complete list of marketplaceId values.

Seller Id

A selling partner identifier, such as a seller account or vendor code. <strong>Important:</strong> Required when identifiersType is SKU.

A2EXAMPLE123456
Stock Keeping Unit (SKU)

A selling partner provided identifier for an Amazon listing.

MY-PRODUCT-SKU-001
Example Payload for Delete Listings Item⤓
Loading…

Delete Subscription By ID​

Deletes the subscription indicated by the subscription identifier and notification type that you specify. | key: deleteSubscription

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Notification Type

The type of notification. See the Notifications API documentation for available notification types.

Subscription Id

The identifier for the subscription that you want to delete.

7fcacc7e-727b-11e9-8848-1681be663d3e
Example Payload for Delete Subscription By ID⤓
Loading…

Get Catalog Item​

Retrieves details for an item in the Amazon catalog. | key: getCatalogItem

InputNotesExample
Amazon Standard Identification Number (ASIN)

The Amazon Standard Identification Number (ASIN) of the item.

B07H65KP63
Connection

The Amazon Seller Central connection to use.

Included Data

List of data sets to include in the response. Default: summaries.

Locale

Locale for retrieving localized summaries. Defaults to the primary locale of the marketplace.

en_US
Marketplace Ids

List of MarketplaceId values. Used to select orders that were placed in the specified marketplaces. See the Marketplace IDs documentation for a complete list of marketplaceId values.

Example Payload for Get Catalog Item⤓
Loading…

Get Destination​

Returns information about the destination that you specify. | key: getDestination

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Destination Id

The identifier generated when you created the destination.

amzn1.sp-api.destination.12345678-90ab-cdef-1234-567890abcdef
Example Payload for Get Destination⤓
Loading…

Get Feed​

Returns feed details (including the resultDocumentId, if available) for the feed that you specify. | key: getFeed

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Feed Id

The identifier for the feed. This identifier is unique only in combination with a seller ID.

50017017797
Example Payload for Get Feed⤓
Loading…

Get Feed Document​

Returns the information required for retrieving a feed document's contents. | key: getFeedDocument

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Feed Document Id

The identifier of the feed document.

amzn1.tortuga.3.edbcd0d8-3434-8222-ac6f-bac123456789.T1URXX1LHU1Q
Example Payload for Get Feed Document⤓
Loading…

Get Listings Item​

Returns details about a listings item for a selling partner. | key: getListingsItem

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Included Data

List of data sets to include in the response. Default: summaries.

Issue Locale

A locale for localization of issues. When not provided, the default language code of the first marketplace is used. Examples: 'en_US', 'fr_CA', 'fr_FR'. Localized messages default to 'en_US' when a localization is not available in the specified locale.

en_US
Marketplace Ids

List of MarketplaceId values. Used to select orders that were placed in the specified marketplaces. See the Marketplace IDs documentation for a complete list of marketplaceId values.

Seller Id

A selling partner identifier, such as a merchant account or vendor code.

A2EXAMPLE123456
Stock Keeping Unit (SKU)

A selling partner provided identifier for an Amazon listing.

MY-PRODUCT-SKU-001
Example Payload for Get Listings Item⤓
Loading…

Get Order​

Returns the order that you specify. | key: getOrder

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Order Id

An Amazon-defined order identifier in 3-7-7 format.

123-1234567-1234567
Example Payload for Get Order⤓
Loading…

Get Order Address​

Returns the shipping address for the order that you specify. | key: getOrderAddress

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Order Id

An Amazon-defined order identifier in 3-7-7 format.

123-1234567-1234567
Example Payload for Get Order Address⤓
Loading…

Get Order Buyer Info​

Returns buyer information for the order that you specify. | key: getOrderBuyerInfo

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Order Id

An Amazon-defined order identifier in 3-7-7 format.

123-1234567-1234567
Example Payload for Get Order Buyer Info⤓
Loading…

Get Order Items​

Returns detailed order item information for the order that you specify. | key: getOrderItems

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Next Token

String token returned in the response of your previous request for pagination.

amzn1.aos.4e9ba8a1-1234-5678-90ab-cdef12345678
Order Id

An Amazon-defined order identifier in 3-7-7 format.

123-1234567-1234567
Example Payload for Get Order Items⤓
Loading…

Get Order Items Buyer Info​

Returns buyer information for the order items in the order that you specify. | key: getOrderItemsBuyerInfo

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Order Id

An Amazon-defined order identifier in 3-7-7 format.

123-1234567-1234567
Example Payload for Get Order Items Buyer Info⤓
Loading…

Get Shipment​

Returns the shipment information for an existing shipment. | key: getShipment

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Shipment Id

The Amazon-defined shipment identifier for the shipment.

6f77095e-9f75-47eb-aaab-a42d5428fa1a
Example Payload for Get Shipment⤓
Loading…

Get Subscription By ID​

Returns information about a subscription for the specified notification type. The getSubscriptionById API is grantless. For more information, see Grantless operations in the Selling Partner API Developer Guide. | key: getSubscriptionById

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Notification Type

The type of notification. See the Notifications API documentation for available notification types.

Subscription Id

The identifier for the subscription that you want to get.

7fcacc7e-727b-11e9-8848-1681be663d3e
Example Payload for Get Subscription By ID⤓
Loading…

List Destinations​

Returns information about all destinations. | key: listDestinations

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Example Payload for List Destinations⤓
Loading…

List Feeds​

Returns feed details for the feeds that match the filters that you specify. | key: listFeeds

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Created Since

The earliest feed creation date and time for feeds included in the response in ISO 8601 format. The default is 90 days ago. Feeds are retained for a maximum of 90 days.

2024-01-01T00:00:00.000Z
Created Until

The latest feed creation date and time for feeds included in the response in ISO 8601 format. The default is now.

2024-12-31T23:59:59.999Z
Feed Types

List of feed types used to filter feeds. When feedTypes is provided, the other filter parameters (processingStatuses, marketplaceIds, createdSince, createdUntil) and pageSize may also be provided. <strong>Important:</strong> Either feedTypes or nextToken is required.

POST_PRODUCT_DATA
Marketplace Ids

List of MarketplaceId values. Used to select orders that were placed in the specified marketplaces. See the Marketplace IDs documentation for a complete list of marketplaceId values.

Next Token

String token returned in the response of your previous request for pagination.

amzn1.aos.4e9ba8a1-1234-5678-90ab-cdef12345678
Page Size

The maximum number of feeds to return in a single call.

25
Processing Statuses

List of processing statuses used to filter feeds.

Example Payload for List Feeds⤓
Loading…

List Orders​

Returns orders created or updated during the time frame indicated by the specified parameters. | key: listOrders

InputNotesExample
Actual Fulfillment Supply Source Id

Denotes the recommended sourceId where the order should be fulfilled from.

SOURCE-12345
Amazon Order Ids

List of AmazonOrderId values. An AmazonOrderId is an Amazon-defined order identifier in 3-7-7 format.

123-1234567-1234567
Buyer Email

The email address of a buyer. Used to select orders that contain the specified email address.

buyer@example.com
Connection

The Amazon Seller Central connection to use.

Created After

Date used for selecting orders created after (or at) a specified time in ISO 8601 format. Only orders placed after the specified time are returned. Either the CreatedAfter parameter or the LastUpdatedAfter parameter is required.

2024-01-15T10:30:00.000Z
Created Before

Date used for selecting orders created before (or at) a specified time in ISO 8601 format. Only orders placed before the specified time are returned.

2024-12-31T23:59:59.999Z
Easy Ship Shipment Statuses

List of EasyShipShipmentStatus values. Used to select Easy Ship orders with statuses that match the specified values. If EasyShipShipmentStatus is specified, only Amazon Easy Ship orders are returned.

Electronic Invoice Statuses

List of ElectronicInvoiceStatus values. Used to select orders with electronic invoice statuses that match the specified values.

Fulfillment Channels

List that indicates how an order was fulfilled. Filters the results by fulfillment channel. Possible values: AFN (Fulfillment by Amazon); MFN (Fulfilled by the seller).

Is ISPU

When true, this order is marked to be picked up from a store rather than delivered.

false
Last Updated After

Date used for selecting orders that were last updated after (or at) a specified time in ISO 8601 format. An update is defined as any change in order status, including the creation of a new order. Includes updates made by Amazon and by the seller.

2024-01-15T10:30:00.000Z
Last Updated Before

Date used for selecting orders that were last updated before (or at) a specified time in ISO 8601 format. An update is defined as any change in order status, including the creation of a new order. Includes updates made by Amazon and by the seller.

2024-12-31T23:59:59.999Z
Marketplace Ids

List of MarketplaceId values. Used to select orders that were placed in the specified marketplaces. See the Marketplace IDs documentation for a complete list of marketplaceId values.

Max Results Per Page

Maximum number of orders that can be returned per page. Value must be 1 - 100. Default 100.

50
Next Token

String token returned in the response of your previous request for pagination.

amzn1.aos.4e9ba8a1-1234-5678-90ab-cdef12345678
Order Statuses

List of OrderStatus values used to filter the results. Select one or more of: PendingAvailability, Pending, Unshipped, PartiallyShipped, Shipped, Canceled, Unfulfillable, or InvoiceUnconfirmed.

Payment Methods

List of payment method values. Used to select orders paid using the specified payment methods. Possible values: COD (Cash on delivery); CVS (Convenience store payment); Other (Any payment method other than COD or CVS).

Seller Order Id

An order identifier that is specified by the seller. Used to select only the orders that match the order identifier. <strong>Important:</strong> If SellerOrderId is specified, then FulfillmentChannels, OrderStatuses, PaymentMethod, LastUpdatedAfter, LastUpdatedBefore, and BuyerEmail cannot be specified.

ORDER-12345
Store Chain Store Id

The store chain store identifier. Linked to a specific store in a store chain.

STORE-12345
Example Payload for List Orders⤓
Loading…

List Subscription​

Returns information about subscriptions of the specified notification type. | key: listSubscriptions

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Notification Type

The type of notification. See the Notifications API documentation for available notification types.

Example Payload for List Subscription⤓
Loading…

Raw Request​

Send raw HTTP request to Amazon Seller Central | key: rawRequest

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Data

The HTTP body payload to send to the URL.

{"exampleKey": "Example Data"}
Debug Request

Enabling this flag will log out the current request.

false
File Data

File Data to be sent as a multipart form upload.

[{key: "example.txt", value: "My File Contents"}]
File Data File Names

File names to apply to the file data inputs. Keys must match the file data keys above.

Form Data

The Form Data to be sent as a multipart form upload.

[{"key": "Example Key", "value": new Buffer("Hello World")}]
Header

A list of headers to send with the request.

User-Agent: curl/7.64.1
Max Retry Count

The maximum number of retries to attempt. Specify 0 for no retries.

0
Method

The HTTP method to use.

Query Parameter

A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.

Response Type

The type of data you expect in the response. You can request json, text, or binary data.

json
Retry On All Errors

If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.

false
Retry Delay (ms)

The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.

0
Timeout

The maximum time that a client will await a response to its request

2000
URL

Input the path only (/orders/v0/orders), The base URL is already included (https://sellingpartnerapi-na.amazon.com/). For example, to connect to https://sellingpartnerapi-na.amazon.com/orders/v0/orders, only /orders/v0/orders is entered in this field.

/orders/v0/orders
Use Exponential Backoff

Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.

false

Search Catalog Item​

Search for and return a list of Amazon catalog items and associated information either by identifier or by keywords. | key: searchCatalogItem

InputNotesExample
Brand Names

List of brand names to limit the search for keywords-based queries. <strong>Important:</strong> Cannot be used with identifiers.

Samsung
Classification Ids

List of classification identifiers to limit the search for keywords-based queries. <strong>Important:</strong> Cannot be used with identifiers.

12345678
Connection

The Amazon Seller Central connection to use.

Identifiers

List of product identifiers to search the Amazon catalog for. <strong>Important:</strong> Cannot be used with keywords.

B07H65KP63
Identifiers Type

Type of product identifiers to search the Amazon catalog for. <strong>Important:</strong> Required when identifiers are provided.

Included Data

List of data sets to include in the response. Default: summaries.

Keywords

List of words to search the Amazon catalog for. <strong>Important:</strong> Cannot be used with identifiers.

laptop
Keywords Locale

The language of the keywords provided for keywords-based queries. Defaults to the primary locale of the marketplace. <strong>Important:</strong> Cannot be used with identifiers.

en_US
Locale

Locale for retrieving localized summaries. Defaults to the primary locale of the marketplace.

en_US
Marketplace Ids

List of MarketplaceId values. Used to select orders that were placed in the specified marketplaces. See the Marketplace IDs documentation for a complete list of marketplaceId values.

Page Size

The maximum number of feeds to return in a single call.

25
Page Token

Token to fetch a certain page when there are multiple pages worth of results.

amzn1.page.12345678-90ab-cdef-1234-567890abcdef
Seller Id

A selling partner identifier, such as a seller account or vendor code. <strong>Important:</strong> Required when identifiersType is SKU.

A2EXAMPLE123456
Example Payload for Search Catalog Item⤓
Loading…

Update Listings Item​

Partially update (patch) a listings item for a selling partner. | key: updateListingsItem

InputNotesExample
Connection

The Amazon Seller Central connection to use.

Issue Locale

A locale for localization of issues. When not provided, the default language code of the first marketplace is used. Examples: 'en_US', 'fr_CA', 'fr_FR'. Localized messages default to 'en_US' when a localization is not available in the specified locale.

en_US
Marketplace Ids

List of MarketplaceId values. Used to select orders that were placed in the specified marketplaces. See the Marketplace IDs documentation for a complete list of marketplaceId values.

Patches

One or more JSON Patch operations to perform on the listings item.

[
  {
    "op": "replace",
    "path": "/attributes/fulfillment_availability",
    "value": [
      {
        "fulfillment_channel_code": "DEFAULT",
        "quantity": 10
      }
    ]
  }
]
Product Type

The Amazon product type of the listings item.

LUGGAGE
Seller Id

A selling partner identifier, such as a seller account or vendor code. <strong>Important:</strong> Required when identifiersType is SKU.

A2EXAMPLE123456
Stock Keeping Unit (SKU)

A selling partner provided identifier for an Amazon listing.

MY-PRODUCT-SKU-001
Example Payload for Update Listings Item⤓
Loading…

Changelog​

2026-04-30​

Updated spectral version

2026-04-21​

Added New and Updated Records polling trigger that checks for new and updated orders or feeds in Amazon Seller Central on a configured schedule

2026-03-31​

Various modernizations and documentation updates

2026-03-13​

Removed the Debug Request input from all action inputs. Debug logging is now controlled internally and no longer appears as a configurable field in actions.

2026-02-26​

Added Select Subscription inline data source with notification type filtering to enable dynamic dropdown selection

2026-01-28​

Added inline data sources for Order ID, Feed ID, and Destination ID inputs to enable dynamic dropdowns.