ads_create_stream_subscription
Create an Amazon Marketing Stream subscription: Amazon pushes one dataset (dataSetId, from Amazon's Marketing Stream data guide) to an AWS SQS queue or Firehose stream the seller o
writeAmazon Adsads.marketing-stream
wns (destination ARN). Only for a seller who already runs that AWS endpoint; read the new subscription's status with ads_get_stream_subscription. Amazon Ads API · CreateStreamSubscription · POST /streams/subscriptions Docs: https://advertising.amazon.com/API/docs/en-us/amazon-marketing-stream/openapi#tag/Stream-Subscription/operation/CreateStreamSubscription Gate: approve — interactive: show the change (Amazon's preview first where one exists), wait for an explicit approve; autopilot: only when the seller's own words asked for this change; otherwise ask.
Call it
In an AI client (MCP)
{
"name": "ads_create_stream_subscription",
"arguments": {
"store": "myStore-US",
"countryCode": "<countryCode>",
"body": {}
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/ads_create_stream_subscription \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","countryCode":"<countryCode>","body":{}}'Arguments
| Name | Type | Description |
|---|---|---|
storerequired | string | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
countryCoderequired | string | the Ads profile's 2-letter country code (e.g. 'US'). |
bodyrequired | object | the request body — its fields, enums and required marks are in this parameter's schema. |
Result
Every tool answers {notification, data, human_action}; data carries:
- Amazon's payload in data.result.
data.result.subscriptionId— for ads_get_stream_subscription / ads_update_stream_subscription.