Connect Amazon Account

This guide covers first-time OAuth connection and reconnect procedures for Amazon Advertising + Seller Central access used by Prism.

Prerequisites

• Signed in to Prism
• Team membership established
• Amazon credentials with permission to authorize advertising access

Expected outcome: You can initiate OAuth with required identity and team context present.

Quick Start

1. Open Onboarding > Connect Amazon or Settings > Amazon Accounts.
2. Click Connect.
3. Complete Amazon authorization.
4. Return to Prism and choose a profile if prompted.
5. Choose a marketplace and continue to Dashboard.

Expected outcome: Account is connected and eligible for data sync.

Detailed Workflows

Workflow: First-Time Connection

1. Start on Connect Amazon page.
2. Review the requested Amazon permission scopes before continuing.
3. Authorize via Amazon-hosted screen.
4. Return to Prism callback.
5. If one profile is returned, Prism auto-completes the selection.
6. If multiple profiles exist, select the advertising profile with the active campaigns you want to manage.
7. Note that some non-US profiles may appear as Coming Soon and cannot be selected in the current free-tier onboarding flow.
8. Continue to marketplace selection.
9. Pick any marketplace already marked Ready, Syncing..., or Setting up....
10. Open Dashboard and verify data load.

Expected outcome: Full onboarding path completes from OAuth to operational pages.

Workflow: Reconnect Expired Tokens

1. Open account settings and review token indicators.
2. Click reconnect/re-authenticate from the connection status card.
3. Complete OAuth again.
4. Return to app and verify status indicators.

Expected outcome: Connection status returns to active and sync resumes.

Workflow: Recover Failed Marketplace Setup

1. Open marketplace selection screen.
2. Identify failed marketplace section.
3. Click Retry on failed marketplace.
4. Confirm the marketplace moves back into Setting up... or another selectable state.
5. If retry limit is exceeded, escalate with the exact marketplace and retry history.

Expected outcome: Marketplace recovers or is escalated with clear retry history.

Common Errors

Error: NO_TEAM during connect

1. Confirm team membership in Settings.
2. Re-authenticate session if team context is stale.
3. Retry connect.

Expected outcome: OAuth initiation succeeds with valid team context.

Error: Callback completed but account missing

1. Re-run connection.
2. Ensure profile selection step is completed.
3. Return to Dashboard and confirm the new account context is present.

Expected outcome: Account persistence is validated after callback.

Error: Marketplace list not selectable

1. Refresh account context.
2. Retry failed marketplaces if present.
3. Select any marketplace already marked Ready, Syncing..., or Setting up....

Expected outcome: Marketplace selection unblocks app navigation.

FAQ

Does Prism ever see my Amazon password?

Authorization is handled through OAuth; password entry occurs on Amazon-hosted pages.

If I reconnect later, do I lose my history?

Yes. Reconnect restores access and does not clear existing team data records.

Can my team connect more than one Amazon account?

Yes, multi-account management is supported in account settings.

Will Prism pick the right profile for me automatically?

No. Prism auto-submits only when Amazon returns exactly one profile. Multi-profile accounts still require explicit selection.

Last Updated

• Last updated: 2026-03-18
• Version assumptions: current ConnectAmazon, ProfileSelect, MarketplaceSelect, reconnect flow, profile auto-submit behavior, and marketplace retry UX