POSThttps://api.nexscope.ai/api/skill-api/v1/skills/amazon-ads-manager/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-ads-manager/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 sp.list_campaigns. Example: 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: { "campaignIdFilter": { "include": [ "123456789" ] }, "maxResults": 10 }
`queryString`	`string`	optional	Optional operation-specific query string without a leading ?; do not use it for SP POST /list filters.

Code example

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

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
sp.create_ad_groups	Create Ad Groups	Preview and confirm
sp.create_budget_rules	Create Budget Rules	Preview and confirm
sp.create_budget_rules_association	Create Budget Rules Association	Preview and confirm
sp.create_campaign_negative_keywords	Create Campaign Negative Keywords	Preview and confirm
sp.create_campaign_negative_targets	Create Campaign Negative Targets	Preview and confirm
sp.create_campaigns	Create Campaigns	Preview and confirm
sp.create_keywords	Create Keywords	Preview and confirm

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

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

Amazon Ads Manager

What this API does

Amazon Ads Manager

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