Amazon Selling Partner Integration

Field	Description	Required	Format
Client ID	Amazon SP-API OAuth App Client ID from your developer application	Yes	`-`
Client Secret	Amazon SP-API OAuth App Client Secret	Yes	`-`
SP-API Base URL	Selling Partner API regional endpoint. Use https://sellingpartnerapi-na.amazon.com for North America (default), https://sellingpartnerapi-eu.amazon.com for Europe, or https://sellingpartnerapi-fe.amazon.com for the Far East. Pick the endpoint that matches your seller account’s region.	Yes	`https://sellingpartnerapi-na.amazon.com`

check_fba_inventory_levels — Retrieves inventory summaries from Amazon fulfillment centers to monitor stock availability

Parameters

string

required

The Amazon Marketplace ID (e.g. ATVPDKIKX0DER for US)

boolean

Set to true to return inventory summaries with additional summarized inventory details and quantities (Default: false)

string

A start date and time in ISO8601 format. If specified, all inventory summaries that have changed since then are returned. Must be no earlier than 18 months prior to the current date.

array

A list of seller SKUs for which to return inventory summaries (up to 50 SKUs). Elements are strings.

Response

{
  "$defs": {
    "InventorySummary": {
      "additionalProperties": false,
      "properties": {
        "asin": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Asin"
        },
        "fn_sku": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Fn Sku"
        },
        "seller_sku": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Seller Sku"
        },
        "condition": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Condition"
        },
        "total_quantity": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Total Quantity"
        },
        "product_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Product Name"
        }
      },
      "title": "InventorySummary",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "inventory_summaries": {
      "items": {
        "$ref": "#/$defs/InventorySummary"
      },
      "title": "Inventory Summaries",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "CheckFbaInventoryLevelsOutput",
  "type": "object"
}

fetch_orders_by_date_range — Retrieves a list of orders based on a specified date range, buyer email, or order ID

Parameters

string

required

The Amazon Marketplace ID

string

required

Fetch orders created after this ISO date

string

Fetch orders created before this ISO date

string

The email address of a buyer to filter orders

string

An order identifier specified by the seller. If provided, other filters like FulfillmentChannels, OrderStatuses, PaymentMethod cannot be used.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "orders": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Orders",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "FetchOrdersByDateRangeOutput",
  "type": "object"
}

generate_sales_inventory_reports — Requests reports on sales, inventory, and fulfillment performance

Parameters

array

required

A list of report types used to filter reports. Refer to SP-API Report Type Values documentation. Elements are strings.

string

The Amazon Marketplace ID to filter reports

array

A list of processing statuses used to filter reports. Valid values: CANCELLED, DONE, FATAL, IN_PROGRESS, IN_QUEUE. Elements are strings.

string

The earliest report creation date and time in ISO 8601 format. Default is 90 days ago.

string

The latest report creation date and time in ISO 8601 format. Default is now.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "reports": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Reports",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "GenerateSalesInventoryReportsOutput",
  "type": "object"
}

get_order_details — Fetches detailed information about a specific order using its order ID

Parameters

string

required

The Amazon Marketplace ID

string

required

The Amazon order ID to fetch details for

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "order": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Order"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetOrderDetailsOutput",
  "type": "object"
}

list_inbound_shipments — Fetches inbound shipment details to track stock movement and replenishment

Parameters

string

required

The Amazon Marketplace ID

array

required

Filter inbound shipments by status. Valid values: WORKING, SHIPPED, RECEIVING, CANCELLED, DELETED, CLOSED, ERROR, IN_TRANSIT, DELIVERED, CHECKED_IN. Elements are strings.

string

A date for selecting inbound shipments that were last updated after (or at) a specified time

string

A date for selecting inbound shipments that were last updated before (or at) a specified time

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "shipments": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Shipments",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListInboundShipmentsOutput",
  "type": "object"
}

list_marketplace_id_options — Retrieves available marketplace participation options for the authenticated seller

Response

{
  "$defs": {
    "MarketplaceOption": {
      "additionalProperties": false,
      "properties": {
        "label": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Label"
        },
        "value": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Value"
        }
      },
      "title": "MarketplaceOption",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "marketplaces": {
      "items": {
        "$ref": "#/$defs/MarketplaceOption"
      },
      "title": "Marketplaces",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListMarketplaceIdOptionsOutput",
  "type": "object"
}

optimize_product_pricing — Retrieves competitive pricing data to adjust product prices dynamically based on market trends

Parameters

string

required

The Amazon Marketplace ID

string

required

Indicates whether ASIN values or seller SKU values are used to identify items. Valid values: Asin, Sku

array

required

A list of ASINs or seller SKUs depending on item_type (up to 20 identifiers). Elements are strings.

string

required

Filters the offer listings based on customer type. Valid values: Consumer, Business

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "pricing_data": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Pricing Data",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "OptimizeProductPricingOutput",
  "type": "object"
}

retrieve_sales_performance_reports — Fetches sales order metrics for visualization in dashboarding tools

Parameters

string

required

The Amazon Marketplace ID

string

required

A time interval for selecting order metrics. Two dates separated by two hyphens (first date inclusive; second exclusive) in ISO8601 format. Example: 2018-09-01T00:00:00-07:00—2018-09-04T00:00:00-07:00

string

required

The granularity of the grouping of order metrics. Valid values: Hour, Day, Week, Month, Year, Total

string

An IANA-compatible time zone for determining the day boundary. Required when specifying a granularity value greater than Hour.

string

Filters results by buyer type. Valid values: All, B2B, B2C

string

Filters results by fulfillment network. Valid values: MFN (merchant fulfillment), AFN (Amazon fulfillment)

string

Specifies the day that the week starts on when granularity=Week. Valid values: Monday, Sunday. Default: Monday

string

Filters results by ASIN. Cannot be specified together with sku.

string

Filters results by SKU. Cannot be specified together with asin.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "order_metrics": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Order Metrics",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "RetrieveSalesPerformanceReportsOutput",
  "type": "object"
}

Using

Providers

Building

Tools

Amazon Selling Partner Integration for AI Agents & Workflows

Overview

Authentication

OAuth2 Authentication

Required Credentials

OAuth Configuration

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Etsy

Google Merchant Center

Instacart

Links

​Overview

​Authentication

​OAuth2 Authentication

​Required Credentials

​OAuth Configuration

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Response

​Parameters

​Response

​Parameters

​Response

​Limits & Quotas

​Related integrations

Etsy

Google Merchant Center

Instacart

​Links

Overview

Authentication

OAuth2 Authentication

Required Credentials

OAuth Configuration

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Related integrations

Links