Faire now supports shop currencies in addition to USD, and the API changes are being made to both v1 and v2 endpoints.
When a shop uses a currency other than USD, all existing price fields in the response are returned as null in API v1. To address this, Faire has added new price fields exclusively in API v2 and deprecated the v1 endpoints. No maintenance or enhancements will be provided for API v1 going forward. Therefore, it is recommended and required that all Faire administrators migrate their API v1 endpoints to API v2 as soon as possible.
As part of this transition, Celigo removed all Faire API v1 endpoints from integrator.io with the 2022.R4 release (November 08, 2022).
This article explains how to identify Faire API v1 endpoints in your existing flows and replace them with the corresponding API v2 endpoints.
Additional reference: Migrating from the v1 API
Although we originally communicated this migration requirement in 2022, several users continue to use API v1 endpoints.
Faire has announced a final deprecation date of December 15, 2025. After this date, all Faire API v1 calls will fail, and any Celigo flows that use v1 exports or imports will stop functioning.
Users must:
-
Update all remaining v1 export or import steps to their corresponding API v2 endpoints.
-
Remove all v1 endpoints from active flows before December 15, 2025.
Celigo will automatically update any remaining API v1 connections as part of an internal migration; however, this update will not modify flow-level exports or imports. Users must replace the endpoints manually as explained here:Faire v1 endpoints with v2 replacement endpoints
Below is the list of export replacement endpoints:
|
v1 endpoints |
v2 endpoints |
|---|---|
|
Get All Products |
Get All Products |
|
Get A Product By ID |
Get A Product By ID |
|
Get All Taxonomy Types |
Get All Taxonomy Types |
|
Get All Orders |
Get All Orders |
|
Get A Single Order By ID |
Get A Single Order By ID |
|
Get Brand Profile |
Get Brand Profile |
Below is the list of import replacement endpoints:
|
v1 endpoints |
v2 endpoints |
|---|---|
|
Create a Product Option |
Create a Product Variant |
|
Update a Product Option |
Update a Product Variant |
|
Delete a Product Option |
Delete a Product Variant |
|
Update Inventory Levels |
Update inventory levels by variant SKUs |
|
Accept an Order |
Accept an Order |
|
Add Shipments to an Order |
Add Shipments to an Order |
|
Delete a Product |
Delete a Product |
Below is the list of price fields that will be null when the shop currency is not USD.
Product Variants:
|
Fields that might be null |
Replacement/suggested fields |
|---|---|
|
retail_price_cents |
Retail_price.amount_minor (field inside Price array) |
|
wholesale_price_cents |
Wholesale_price.amount_minor (field inside Price array) |
Order Items:
|
Fields that might be null |
Replacement/suggested fields |
|---|---|
|
price_cents |
price.amount_minor |
|
tester_price_cents |
tester_price.amount_minor |
Shipments:
|
Fields that might be null |
Replacement/suggested fields |
|---|---|
|
maker_cost_cents |
maker_cost.amount_minor |
Payout Costs:
|
Fields that might be null |
Replacement/suggested fields |
|---|---|
|
payout_fee_cents |
payout_fee.amount_minor |
|
commission_cents |
commission.amount_minor |
Notice
If you have changed your shop currency from USD to another currency and you are using the v1 and price_cents field to pull up the prices from the order items, either you will be getting a null value or no price_cents field in the response. Faire didn’t introduce any replacement price field for it in v1. But in v2, instead, they have introduced a replacement currency field called price.amount_minor for retrieving the prices of an order item.
To find each import and export that uses a Faire connection:
-
Sign in to your integrator.io account.
-
Navigate to Resources > Connections.
-
Search for an existing Faire connection, from the Actions overflow ... menu, select Used by. A list of all items that use this connection appears.
-
Right-click the first flow step in the list and select your browser’s option to open it in a new tab.
-
Review the configuration for any of the v1 endpoints listed in the above table:
When you encounter a v1 endpoint, first copy the path parameter and search parameter values to a reference document to back them up when replacing the endpoints.
For each export and import containing a v1 endpoint, replace it with the v2 endpoint by referring to the Faire v1 endpoints with v2 replacement endpoints section, and update the flow by mapping with respective endpoints.