The Iconic
Connect The Iconic to run your marketplace store: list products, update stock and prices, ship orders, handle returns and read statements.
You paste the Application ID and Application Secret of an OAuth application you make in your own THE ICONIC Seller Center. There is nothing to request from anyone once you have a seller login.
Seller/marketplace approval before this connector works
You need to be a seller on THE ICONIC's marketplace, with a login to Seller Center. THE ICONIC takes on new brands through its Sell With Us page. Once you have a login, the application takes a minute and needs no approval.
- Typical wait
- THE ICONIC publishes no turnaround for new brands. For a seller who already has a login, there is no wait.
- Cost
- THE ICONIC's API guide mentions no fee for API access. Ask THE ICONIC about the terms for selling on its marketplace.
- Blocked until approved
- The whole connection, since the application is made inside Seller Center.
- Works meanwhile
- Nothing on your own: Seller Center and its API are for sellers.
Where to apply: Start at theiconic.com.au/sell-with-us. If you already sell there, add an application in Seller Center under Settings, OAuth Applications.
- Make the application with a user that has the Seller Full Access role, as THE ICONIC's API guide asks.
- Some features, such as manifests, only work when they are switched on for your seller.
- An application has no read-only setting. Leave the connection read-only in PopMCP to block changes.
- Setup time
- 2 min
- Auth
- API credentials
- API base URL
- https://sellercenter-api.theiconic.com.au/. Access tokens come from https://sellercenter.theiconic.com.au/oauth/client-credentials and last one hour; PopMCP renews them for you.
- Rate limits
- 30 requests per second per seller, shared by all your applications. Over that Seller Center answers HTTP 429. Bulk background operations are limited each day to 50,000 rows plus 5 rows for each product you have.
Before you begin
- A THE ICONIC marketplace seller account, with a login to Seller Center. This is for brands selling on THE ICONIC, not for shoppers.
- A Seller Center user with the Seller Full Access role. THE ICONIC's API guide asks that the application is made by a user with that role.
Get your credentials
Open OAuth Applications
Sign in to Seller Center at sellercenter.theiconic.com.au with a user that has the Seller Full Access role. Open Settings, then OAuth Applications.
OAuth Applications
Applications you make here can call the Seller Center API as your seller.
Add an application for PopMCP
Add a new application and name it PopMCP. Seller Center keeps a redirect address with each application. If it asks for one, enter https://app.popmcp.com: this kind of connection never uses it.
OAuth Applications
Copy the Application ID and Application Secret
Seller Center generates an Application ID and an Application Secret for the new application. Copy both.
OAuth Applications
| Name | Application ID |
|---|---|
| PopMCP | 1234****be97 |
Keep the Application Secret private. Anyone holding it can act as your seller.
Paste both into PopMCP
In PopMCP, open The Iconic, paste the Application ID and Application Secret, and connect. PopMCP gets an access token with them and reads your seller's name, so you can see straight away that it is the right account.
Allow changes when you are ready
New connections start read-only, so the AI can read products, orders and statements and nothing else. Applications have no read-only setting of their own. When you want the AI to change stock or prices or move orders along, an owner or admin can allow writes in PopMCP.
Connect in PopMCP
Open your workspace, choose The Iconic in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| Application IDtext | In Seller Center, open Settings, then OAuth Applications, and add an application named PopMCP. If it asks for a redirect address, enter https://app.popmcp.com (this connection does not use it). Then copy its Application ID. |
| Application Secretsecret | Shown with the same application. Stored encrypted and used only on our servers to get access tokens.Encrypted with AES-256-GCM on save and never shown again. |
PopMCP verifies the credential against The Iconic immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
PopMCP shows The Iconic as Verified, named after your seller. Ask for your order counts: the_iconic_get_order_counters answers with how many orders sit in each status.
Troubleshooting
"Seller Center did not accept this Application ID and Application Secret"
Why: One of the values was copied incompletely, they come from different applications, or the application was deleted.
Fix: Copy both again from Settings, OAuth Applications, or add a new application.
"Seller Center accepted the application but refused to show its seller"
Why: The application was made by a user without enough access.
Fix: Sign in as a user with the Seller Full Access role, add a new application and connect with that one.
That is an email address
Why: You pasted the User ID of Seller Center's older API, which sits with its API key in the API Explorer section.
Fix: PopMCP uses an OAuth application instead. Add one under Settings, OAuth Applications and paste its Application ID.
A bulk import was accepted but the products did not change
Why: Imports run in the background, and errors for each row only appear on the feed.
Fix: Ask the AI to call the_iconic_wait_for_feed with the feedUuid from the answer and read the errors.
A status change is refused
Why: Order items only move along a set path, and the items in one call must be from one order. Setting delivered is for dropship orders only.
Fix: Ask the AI to read the order with the_iconic_order_overview and use the next status for each item.