| name | pm-amazon-ads |
| description | Amazon Ads connector knowledge and safe action guide. |
pm-amazon-ads
Purpose
Reads Amazon Advertising profiles, Sponsored Products campaigns, ad groups, product ads, keywords, negative keywords, and portfolios via the Amazon Ads API using a Login with Amazon (LWA) refresh-token grant. Read-only.
Icon
Capabilities
- check=true catalog=true read=true write=false query=false
- Integration type: api
Authentication
- Use pm credentials add with --from-env or --value-stdin for secret fields.
Configuration
- base_url
- max_pages
- page_size
- profile_id
- token_url
- client_id (secret)
- client_secret (secret)
- refresh_token (secret)
ETL Streams
- profiles:
- primary key: profile_id
- fields: account_id(), account_name(), account_type(), country_code(), currency_code(), daily_budget(), marketplace_string_id(), profile_id(), timezone()
- campaigns:
- primary key: campaign_id
- fields: campaign_id(), campaign_type(), daily_budget(), end_date(), name(), portfolio_id(), premium_bid_adjustment(), start_date(), state(), targeting_type()
- ad_groups:
- primary key: ad_group_id
- fields: ad_group_id(), campaign_id(), default_bid(), name(), state()
- portfolios:
- primary key: portfolio_id
- fields: in_budget(), name(), portfolio_id(), state()
- keywords:
- primary key: keyword_id
- fields: ad_group_id(), bid(), campaign_id(), keyword_id(), keyword_text(), match_type(), state()
- product_ads:
- primary key: ad_id
- fields: ad_group_id(), ad_id(), asin(), campaign_id(), serving_status(), sku(), state()
- negative_keywords:
- primary key: keyword_id
- fields: ad_group_id(), campaign_id(), keyword_id(), keyword_text(), match_type(), state()
Sync Modes
- ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped
Security
- read risk: external Amazon Ads API read of profile, campaign, ad group, product ad, keyword, negative keyword, and portfolio data
- approval: none; read-only, no reverse-ETL write surface
- Never pass secret values in chat, shell arguments, logs, docs, or JSON output.
Commands
Inspect as a manual
pm connectors inspect amazon-ads
Inspect as structured JSON
pm connectors inspect amazon-ads --json
Agent Rules
- Run pm connectors inspect amazon-ads before creating credentials or plans.
- Use --json only when the caller needs structured output; use the manual for human-readable guidance.
- Never ask the user to paste secret values into chat.
