TradeGecko Integration Instructions


These instructions will show you how to configure your Fulfillment Control Panel and TradeGecko accounts to sync orders and inventory levels.

Enable the TradeGecko API

In order to use the TradeGecko API you will need to create a private app for your account. To create a new app visit the link below:

Log in to your account (if requested), and choose New Application.

Next fill out the from as indicated in the screenshot below:

Once the two required fields are filled in click Submit.

On the next screen choose Create Privileged Token.

Finally you will need you copy and paste the Privileged Token that was created and paste it into your Fulfillment Control Panel (FCP) account.

Fulfillment Control Panel Settings

Once you have obtained your Privileged Token you will need to enter it into your Fulfillment Control Panel account. Choose Add Integration from the Integration menu.

Select TradeGecko from the list of available platforms and click the “Add new Integration” button.

Enter your Privileged Token in the field exactly as it appears in your TradeGecko account, making sure there are no leading or trailing spaces.

Next you can specify the "Stock Location" for us to set when we sync inventory back to your account.


This should be the name or "label" of the location.
If you would like to use the default/primary location, you may leave this blank.

Then you will enter the orders status and fulfillment status for orders that should be fulfilled, as well as the number of days back you want to pull orders from (we recommend 5 or less). The order status and fulfillment status combined with the number of days to pull orders from act as a filter for us to choose which orders to pull into our system. In the example below, we will search all orders placed in the last 5 days and only import orders that have a Order Status of Finalized AND a Order Fulfillment Status set to Unshipped,partial.

The next set of options determines the intervals at which we check for new orders and, optionally, send available inventory counts back to TradeGecko (please see the Optional Features section for more information on inventory syncing).

The most common scenario is to check for new orders every 30 minutes and sync inventory twice per day.

If you have more than one TradeGecko account you may assign a “nickname” to each store to better identify options and settings for each one. 

Click the “Add new Integration” button to finalize the integration settings. You should see a success message at the top of your screen. 

To verify that we can connect to your TradeGecko account choose View Integrations from the Integration menu. For each integration you have configured you will see a set of options displayed as colored icons. Click the “suitcase” icon to view the items in your account.

You should see a searchable list of products from your TradeGecko store. The list will indicate if the product SKU matches a SKU in our system.

If you do not see a list of products and, instead, see an error message it is likely that your Privileged Token or one of the other integration options has been entered incorrectly. Please verify these settings and try again.

Shipment & Tracking Updates

There is an approximately 4 hour delay from the time we ship an order until we send tracking numbers back to TradeGecko.

Shipping Methods

When we retrieve your orders from TradeGecko the shipping methods are shown as strings of text such as “Free Shipping” or “USPS International Express” or “Federal Express Ground”. 

This text needs to be translated to our internal codes by setting up mappings within the integration configuration.

From your Fulfillment Control Panel account choose View Integrations from the Integration menu and then click the “envelope” icon to view existing shipping mappings.

Carefully type or “copy and paste” the exact text of your shipping method options from TradeGecko into the Cart Shipping Method field, then choose from the list of available shipping methods. Next, click the “Add Mapping” button, and then click the link in the success message to refresh the list (you will need to do this before you can add another method). Repeat this until all of your cart ship methods are mapped to our internal codes.

Optional Features

We also have a feature which will synchronize the available inventory counts from our warehouse back to your TradeGecko account. This is useful if you don't want to sell products that are out of stock. If you are interested in this feature more information on Inventory Syncing can be found in our standalone guide located here.


Have more questions? Submit a request


Please sign in to leave a comment.
Powered by Zendesk