ads_create_schedule
Run a saved AMC workflow on a schedule — Daily or Weekly — on the store's instance.
writeAmazon Adsads.amc-reporting
Each run appears in ads_list_workflow_executions (filter by its workflow_id). Ask the seller first. Amazon Ads API · createSchedule · POST /amc/reporting/{instanceId}/schedules Docs: https://advertising.amazon.com/API/docs/en-us/amc-reporting#tag/Schedules/operation/createSchedule 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_schedule",
"arguments": {
"store": "myStore-US",
"country_code": "<country_code>",
"body": {}
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/ads_create_schedule \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","country_code":"<country_code>","body":{}}'Early access — the Tool API is open on request, contact us.
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. |
country_coderequired | 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. scheduleId, workflowId (a saved workflow) and aggregationPeriod are needed; scheduleEnabled false saves it paused. The marketplace is the store's. |
Result
Every tool answers {notification, data, human_action}; data carries:
data.schedule_id— the schedule's id.data.workflow_id— the workflow it runs.
Gotchas
- A run's result can be downloaded for about a day; read each run in time.
- A synced report's schedule or workflow (data.synced_ids of the two list tools) is refused.