CJ Dropshipping
Connect CJ Dropshipping to search products, check warehouse stock, quote shipping, create and pay orders, track shipments, and handle disputes.
You paste one value into PopMCP: a CJ Dropshipping API Key. It has the shape CJUserNum@api@\<40-character token> and My CJ only ever shows it masked, as CJ4******38, beside an eye icon and a copy icon.
- Setup time
- 6 min
- Auth
- API credentials
- API base URL
- https://developers.cjdropshipping.com/api2.0/v1
- Rate limits
- The access-token endpoint allows one call per second. An issued access token lasts 15 days by default, the same token is returned from cache for 24 hours per account, and its refresh token lasts 180 days.
Before you begin
- A CJ Dropshipping account, free to register at cjdropshipping.com
- The API app installed from Apps → Install App, in the Others category of the App Store. Until it is installed there is no API entry in the left menu
- Access to the CJ account itself. API keys are minted per CJ account, not per staff seat
Get your credentials
Install the API app from the App Store
Sign in at cjdropshipping.com and open My CJ, then click Apps in the left menu and choose Install App. In the App Store overlay open the Others category, find API, and click the download icon on its card.
App Store
Install the CJ apps your workflow needs.
| App | Category | Status | Action |
|---|---|---|---|
| MiaoshouERPOrder and stock sync | ERP Platform | Not installed | Install |
| APIDeveloper access to CJ endpoints | Others | Installed | Open |
| ShopifyConnect a Shopify store | Store | Not installed | Install |
A toast reading Installed Successfully appears and the download icon becomes a green check.
Open the API page under Apps
Click the new API entry under Apps in the left menu, or go straight to my.html#/authorize/API. Select the API tab rather than API Stores.
API
Authorize API keys for this CJ account.
You haven't authorized any API yet.
Click Add API to create your first key.
Create an API Key
Click Add API and type a name you will recognise later, such as PopMCP, into API Key Name. Leave Same As API Key Name ticked for API Store Name, set Type to API Key, then click Confirm.
API
Copy the key from the API Key & MCP Token column
Find the row whose Type is API Key and whose Status reads Activated. Click the copy icon in the API Key & MCP Token column instead of revealing the value and retyping it.
API (1)
| Name | Type | API Key & MCP Token | Status | Updated Date | Action |
|---|---|---|---|---|---|
| PopMCPPrimary API store | API Key | CJ4******38 | Activated | 2026-07-01 21:44 | Delete |
The eye icon reveals the key and the copy icon puts the full value on the clipboard.
Paste the key into PopMCP
Paste the value into the API Key field in PopMCP and click Connect.
Connect in PopMCP
Open your workspace, choose CJ Dropshipping in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| API Keysecret | My CJ → Apps → Install App → install "API" (Others category), then Authorization → Add API → set Type to API Key → Confirm → copy the key from the API Key column. Stored encrypted and used server-side only to mint CJ access tokens. If the key is ever rotated in CJ, reconnect here with the new one.Encrypted with AES-256-GCM on save and never shown again. |
PopMCP verifies the credential against CJ Dropshipping immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
PopMCP flips CJ Dropshipping to Connected and a first tool call, such as listing product categories, returns CJ data instead of an auth error.
Troubleshooting
Authentication fails right after connecting
Why: The key was retyped or truncated, so the `CJUserNum@api@` prefix is missing or a character was dropped.
Fix: Return to Apps → API and use the copy icon in the API Key & MCP Token column, then reconnect in PopMCP.
There is no API entry under Apps in the left menu
Why: The API app has not been installed from Apps → Install App, in the Others category of the App Store.
Fix: Install the API app first, then reload my.html#/authorize/API.
Too-many-requests errors during the first minutes
Why: CJ limits the token endpoint to one call per second and returns the same cached access token for 24 hours. Repeated reconnects trip the limit.
Fix: Wait a minute and reconnect once. Do not re-save the connector repeatedly.
Connector worked, then started returning auth errors
Why: The key was deleted or regenerated in CJ, or the 180-day refresh token lapsed after a long idle period.
Fix: Create a fresh key with Add API and reconnect PopMCP with the new value.
Not sure whether the key you pasted is complete
Why: CJ keys carry an account prefix. A value without `@api@` in the middle is a partial copy.
Fix: Reveal the key with the eye icon and check it reads `CJUserNum@api@` followed by a long token.