POSThttps://api.nexscope.ai/api/skill-api/v1/skills/amazon-advertising/run

Run this API

Send a JSON request to execute this API and receive the documented response payload.

Endpoint

Method	`POST`
Path	`https://api.nexscope.ai/api/skill-api/v1/skills/amazon-advertising/run`
Auth	`Bearer API key`
Content-Type	`application/json`

Amazon Ads operation guide

Select an operation ID below and send it with an owned connectionId. Read operations return the governed result. Create and update operations require payload and a preview followed by a separate confirmation with the returned single-use confirmationToken. Sponsored Products POST /list filters belong in payload, not queryString.

The table lists the 61 operation IDs accepted by the Nexscope catalog. Use the Nexscope run endpoint shown above; provider paths and credentials are handled by the backend.

Request parameters

Name	Type	Required	Description
`operationId`	`string`	required	Exact catalog operation ID, for example ads_manager.sp.list_campaigns. Example: ads_manager.sp.list_campaigns
`connectionId`	`integer`	required	Owned Amazon Ads connection ID. Example: 123
`payload`	`object`	optional	Documented fields for the selected operation; required by create/update operations. SP POST /list filters such as campaignIdFilter and stateFilter belong in payload as objects with non-empty include arrays of strings. Example: { "maxResults": 10, "campaignIdFilter": { "include": [ "123456789" ] } }
`queryString`	`string`	optional	Optional operation-specific query string without a leading ?; do not use it for SP POST /list filters.

Code example

{
  "connectionId": 123,
  "operationId": "ads_manager.sp.list_campaigns",
  "payload": {
    "maxResults": 10,
    "campaignIdFilter": {
      "include": [
        "123456789"
      ]
    }
  }
}

Response example

Platform response envelope. code 0 indicates success or acceptance; data contains the business result.

{
  "data": {
    "data": {},
    "confirmationToken": "opaque-token",
    "expiresAt": "1760000000000"
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}

Response fields

Name	Type	Required	Description
`data`	`any`	required	Data value used by this API operation.
`code`	`integer`	required	0 means accepted or successful; nonzero is a platform error.
`msg`	`string \| null`	required	Msg value used by this API operation.
`ts`	`string`	required	Epoch milliseconds.
`time`	`string`	required	Server local time: yyyy-MM-dd HH:mm:ss.
`cost`

Responses

Code	Description
200	HTTP request completed. Check JSON code; only 0 indicates business success or acceptance.
400	Request JSON or required API parameters are invalid.
401	API key is missing, invalid, or cannot be matched to a user.
5xx	API execution or upstream service failed.

Data source, freshness, and limitations

Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.

operationId	Action	Access
ads_manager.sp.create_ad_groups	Create Ad Groups	Preview and confirm
ads_manager.sp.create_budget_rules	Create Budget Rules	Preview and confirm
ads_manager.sp.create_budget_rules_association	Create Budget Rules Association	Preview and confirm
ads_manager.sp.create_campaign_negative_keywords	Create Campaign Negative Keywords	Preview and confirm
ads_manager.sp.create_campaign_negative_targets	Create Campaign Negative Targets	Preview and confirm
ads_manager.sp.create_campaigns	Create Campaigns	Preview and confirm
ads_manager.sp.create_keywords	Create Keywords

operationId	Action	Access
ads_manager.sb.create_ad_groups	Create Ad Groups	Preview and confirm
ads_manager.sb.create_ads	Create Ads	Preview and confirm
ads_manager.sb.create_budget_rules	Create Budget Rules	Preview and confirm
ads_manager.sb.create_campaigns	Create Campaigns	Preview and confirm
ads_manager.sb.list_ad_groups	List Ad Groups	Read
ads_manager.sb.list_ads	List Ads	Read
ads_manager.sb.list_budget_rules	List Budget Rules	Read
ads_manager.sb.list_campaigns	List Campaigns	Read
ads_manager.sb.update_ad_groups	Update Ad Groups	Preview and confirm
ads_manager.sb.update_ads	Update Ads	Preview and confirm
ads_manager.sb.update_budget_rules	Update Budget Rules	Preview and confirm
ads_manager.sb.update_campaigns	Update Campaigns	Preview and confirm

operationId	Action	Access
ads_manager.sd.create_ad_groups	Create Ad Groups	Preview and confirm
ads_manager.sd.create_budget_rules	Create Budget Rules	Preview and confirm
ads_manager.sd.create_campaigns	Create Campaigns	Preview and confirm
ads_manager.sd.create_creatives	Create Creatives	Preview and confirm
ads_manager.sd.create_negative_targets	Create Negative Targets	Preview and confirm
ads_manager.sd.create_product_ads	Create Product Ads	Preview and confirm
ads_manager.sd.create_targets	Create Targets	Preview and confirm
ads_manager.sd.list_ad_groups	List Ad Groups	Read
ads_manager.sd.list_budget_rules	List Budget Rules	Read
ads_manager.sd.list_campaigns	List Campaigns	Read
ads_manager.sd.list_creatives	List Creatives	Read
ads_manager.sd.list_negative_targets	List Negative Targets	Read
ads_manager.sd.list_product_ads	List Product Ads	Read
ads_manager.sd.list_targets	List Targets	Read
ads_manager.sd.update_ad_groups	Update Ad Groups	Preview and confirm
ads_manager.sd.update_budget_rules	Update Budget Rules	Preview and confirm
ads_manager.sd.update_campaigns	Update Campaigns	Preview and confirm
ads_manager.sd.update_creatives	Update Creatives	Preview and confirm
ads_manager.sd.update_negative_targets	Update Negative Targets	Preview and confirm
ads_manager.sd.update_product_ads	Update Product Ads	Preview and confirm
ads_manager.sd.update_targets	Update Targets	Preview and confirm

Amazon Advertising

What this API does

Amazon Advertising

What this API does

Authentication

Run an API

Example request

Check the response

HTTP status codes

Run this API

Endpoint

Amazon Ads operation guide

Request parameters

Code example

Response example

Response fields

Responses

Data source, freshness, and limitations

MCP

Call a tool

Legacy MCP v1

Online test

Try it

Related APIs

Any of option 1

Any of option 2