Getting Started Guide for 3PLs

Third-party logistics providers (3PLs) can seamlessly integrate with FlavorCloud to become end-to-end international shipping providers, for both shipping and returns. Integration unlocks the best carriers and rates for your merchants, seamless handling of customs, landed costs, and compliance, as well as end-to-end customer service from pickup to delivery.

Are you a merchant?

The Getting Started Guide is a little different for you. View the Merchant Guide →

Integration steps

Set up a FlavorCloud account

Follow the Getting Started Guide for Merchants to set up a FlavorCloud App and retrieve your AppID and RestApiKey.

Have the merchant add you as a 3PL user

The merchant adds a 3PL user from the Users tab in their FlavorCloud account. Provide your FlavorCloud login email to the merchant so they can grant access.

An email is then sent to the 3PL containing a customer_key. When making API calls on behalf of this merchant, pass the customer_key in the request alongside your AppID and RestApiKey.

Integrate fulfillment with FlavorCloud

Register for the SHIPMENT_COMPLETED event via the Subscribe Webhooks endpoint — you'll be notified when shipments are created. This is the recommended method.

Alternatively, call the Create Shipments endpoint with the Async flag set to false and retrieve tracking and labels directly in the response.

At the time of order fulfillment, call Create Shipments from your WMS. This creates a shipment in FlavorCloud, selects the appropriate carrier and rate based on what was chosen at checkout, and generates the label, customs documentation, and tracking number.

Include AppID, RestApiKey, customer_key, HashKey, DutyHashKey, Reference, and ReasonForExport in the request.

Async flag behavior:

Async: false → response includes ShipmentID along with label, customs doc, and tracking number links.

Async: true → response returns ShipmentID only. Label, customs doc, and tracking number links arrive via the SHIPMENT_COMPLETED webhook callback.

Rate invalidation on field changes

Changes or overrides to any of the following fields will invalidate the rate chosen at checkout and trigger a new rate calculation upon fulfillment:

ShipFromAddress

ShipToAddress

TermsOfTrade

ServiceCode

Carrier

Pieces

Weight

Package.Weight

Next steps

Merchant Guide

Best practices and common setups for the FlavorCloud API, including rates, shipments, manifesting, and tracking.

API Reference

Full endpoint documentation, parameters, and response schemas.

Integration steps#

Next steps#

Integration steps

Next steps