On this page:
Connect UPS account
We will need you to log in to or create your UPS Developer Account and retrieve this information. I've provided the instructions on how to retrieve these items here:
1. Click the link provided. Once on the page, click Create an Application. https://developer.ups.com/?loc=en_US
2. Login to your existing UPS account or create a UPS account.
3. Click Add Apps >
4. Describe the following & click Next:
I need API credentials because: I want to integrate UPS technology into my business.
Choose an account to associate with these credentials: Select which account you would like to connect Corksy to.
5. Fill in your Primary Contact information & click Continue.
6. Add your App Details
App Name: Corksy
Callback URL: copy & paste your website URL (Should include https:// )
7. Add Products. Add all products listed below and click Save.
Authorization (0Auth)
Address Validation
Locator
Rating
Time In Transit
Tracking
Shipping
8. Accept UPS terms & conditions to receive information necessary for the Corksy integration.
9. Now that UPS has provided your Client id & Client secret we will need to add this to your Corksy account.
10. Login to your Corksy account > Settings > Shipping & Delivery > Connect account (UPS) > Integration type: New
11. Enter your UPS Account Number, Client id, Client secret, & Callback URL. Click Save.
Connect FedEx account
To connect your FedEx account to Corksy we will need your FedEx Developer account number, API Key, and Client Secret.
Log in to or create your FedEx Developer Account through the link provided: https://developer.fedex.com/api/en-us/project.html#/myprojects
Once you are in your FedEx Developer account, click on the My Projects tab.
From the My Projects tab, click + CREATE A PROJECT.
When prompted: "Tell us about your API needs" select: Ships with FedEx and is using a third-party software solution that has requested API keys
Fill out the fields for "Provide information about the third-party solution you are using" :
Third-party company: Corksy
Third-party product: eCommerce
Third-party product website: corksy.io
Select API(s) for your project
Ship, Rate, & other APIs
Select the following APIs to enable:
Address Validation API
FedEx Locations Search API
Open Ship API
Rates and Transit Time API
Service Availability API
Ship API
Service Availability API
API Key & Client Secret will generate. Copy and Paste Production Key into Corksy along with your account number.
From your Corksy admin portal, go to Settings → Shipping & Delivery
Select Connect on FedEx
Copy and Paste the API Key, Client Secret, and your Account Number.
Click save.
Create Shipping Zones
Manual shipping rates allow you to enter the price your customer is charged at checkout. This option is recommended to ensure the lowest number of abandoned carts due to high shipping rates. Read more about shipping best practices here.
View the step-by-step guide to setting up manual shipping rates here.
From your Corksy admin portal, go to Settings → Shipping & Delivery
Select Manage Rates → Create Shipping Zone
Give the Shipping Zone a name
(we recommend adding state abbreviations in parentheses, e.g., Northeast (NY, NJ, CT), to make it easy to identify)
Choose the states you want to include in this shipping zone
Select Save
If you're connecting UPS or FedEx for live rates, you only need to create a single shipping zone that includes all the states you can ship to.
Create Manual Shipping Rates
From your Corksy admin portal, go to Settings → Shipping & Delivery
Navigate to the Shipping section and select Manage Rates
Click Add Rate within the desired Shipping Zone
Note: You’ll need to create a shipping zone first. Learn how to add one here.
Select Set up your own rates and select the Shipping Speed
Express (1 to 2 business days)
Custom Rate (set your own)
Economy (5 to 8 business days)
Standard (3 to 4 business days)
(Optional) Click Add Conditions to set parameters:
By Weight: Define weight ranges for the rate (e.g., 10-15 lbs = $30 for Express Shipping)
By Order Price: Define order value ranges for the rate (e.g., $100-$150 = $30 for Express Shipping)
Select Save
📦 Setting Up Conditional Weight-Based Shipping Rates
To ensure accurate and customer-friendly shipping rates, set your conditional weight tiers based on your bottle weight. Below is an example using 3 lbs per bottle:
0-3 lbs: 1 bottle
3.1-6 lbs: 2 bottles
6.1-9 lbs: 3 bottles
9.1-12 lbs: 4 bottles
12.1-15 lbs: 5 bottles
15.1-18 lbs: 6 bottles
18.1-21 lbs: 7 bottles
21.1-24 lbs: 8 bottles
24.1-27 lbs: 9 bottles
27.1-30 lbs: 10 bottles
30.1-33 lbs: 11 bottles
33.1-36 lbs: 12 bottles (Full Case)
Recommendation: Set free shipping at the 12-bottle (36 lbs) tier to encourage full case orders.
Pro Tip: Always base these weight tiers on your actual bottle weight to ensure shipping rates are precise and aligned with your packaging.
💰 Conditional Price-Based Shipping Rates
Set up shipping tiers based on order value to encourage higher purchase amounts. Below is an example:
$0 - $49.99: Standard shipping rate
$50 - $99.99: Discounted shipping rate
$100 - $149.99: Reduced shipping rate (or flat rate)
$150 - $199.99: Free shipping on orders over $150 (recommended to drive higher cart values)
Recommendation: Offering free shipping at $150 or higher incentivizes larger purchases and increases average order value.
Create Carrier Shipping Rates
From your Corksy admin portal, go to Settings → Shipping & Delivery
Navigate to the Shipping section and select Manage Rates
Click Add Rate within the desired Shipping Zone
Note: You’ll need to create a shipping zone first. Learn how to add one here.
Select Use carrier or app to calculate rates and select the Carrier
FedEx
UPS
Choose the Shipping Services you want to display at checkout
Note: Only the selected services will appear for customers at checkout, but you can still purchase labels and fulfill orders using any shipping service.
(Optional) Add a Handling Fee
Click Save
We recommend a 10–15% handling fee to account for the additional weight from the shipping package when purchasing the label.
Create Shipping Packages
From your Corksy admin portal, go to Settings → Shipping & Delivery
Navigate to the Shipping Package section and select + Shipping Package
Enter your Shipping Package details:
Package Name (e.g., "2-Bottle Box")
Length
Width
Height
Weight
Important: This is the empty box weight, including inserts, without bottles