Amazon Advertising

Amazon Ads Manager

Accepts only documented ads_manager.sb/sd/sp operation IDs. Provider methods and paths are derived server-side; mutations require preview followed by confirmation.

post/api/skill-api/v1/skills/amazon-ads-manager/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/amazon-ads-manager/run
  • Auth: HTTP bearer

Headers

X-Nexscope-Http-Status'legacy' | 'semantic'

Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.

Request body

operationIdstring required

Exact catalog operation ID, for example sp.list_campaigns.

connectionIdinteger required

Owned Amazon Ads connection ID.

payloadobject

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.

queryStringstring

Optional operation-specific query string without a leading ?; do not use it for SP POST /list filters.

adTypestring

Required only by sb.create_ads.

actionstring

preview (default) or confirm for mutations; ignored for reads.

confirmationTokenstring

Single-use token required when action is confirm.

Example request

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

Response

Successful response.

codeinteger required

0 means accepted or successful; nonzero is a platform error.

msgstring nullable required
tsstring required

Epoch milliseconds.

timestring required

Server local time: yyyy-MM-dd HH:mm:ss.

coststring required

Elapsed milliseconds, never credits; -1 outside web requests.

traceIdstring nullable required

Example response

{
  "data": {
    "data": {},
    "confirmationToken": "opaque-token",
    "expiresAt": 1760000000000
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.