Amazon Advertising

Amazon Ads API Access

Starts Amazon Ads OAuth authorization or returns safe connection and profile metadata. Access and refresh tokens are never accepted or returned.

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

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/amazon-ads-api-access/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

operationstring required

Operation: authorize, connections, or profiles.

regionstring required

Required when operation=authorize. Amazon Ads region: NA, EU, or FE.

marketplaceIdstring required

Required when operation=authorize. Amazon marketplace identifier.

accountNamestring

Optional display name for the authorization request.

connectionIdinteger

Required when operation=profiles. Owned Amazon Ads connection ID.

Example request

{
  "operation": "authorize",
  "marketplaceId": "ATVPDKIKX0DER",
  "region": "NA",
  "accountName": "US Ads account"
}

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": {
    "authorizationUrl": "https://example.com/authorize",
    "state": "opaque-state",
    "expiresAt": 1760000000000,
    "profiles": []
  }
}

Changes

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