Skip to main content

Pre-Built Tooling

CategoryDetails
AuthenticationAPI Key (X-FAIRE-ACCESS-TOKEN header)
Two-Way SyncYes
Events SupportedYes (Webhooks)
RealtimeYes
Supports Rate LimitingYes
Authentication Scopes SupportedN/A (API Key based authentication)

Objects Supported

Alloy Automation supports syncing the following objects from Faire:
  • Products
  • Orders
  • Brands
  • Inventory
  • Shipments
  • Returns
  • Invoices
  • Retailers

Set Up Guide

Trial Access

QuestionAnswer
Offers free trial?Yes. Faire is free to join for both brands and retailers. Brands can create an account at https://www.faire.com/brand and retailers at https://www.faire.com/retailer.
Requires requires paid sandboxNo paid sandbox required. You can use your Faire account for testing.
Requires partnership to obtain authentication?No. API credentials can be obtained directly from your Faire account settings once approved for API access.

Authentication (API Key)

Faire uses API Key authentication via the X-FAIRE-ACCESS-TOKEN header.
  1. Log in to your Faire account at https://www.faire.com.
  2. Navigate to SettingsIntegrationsAPI Access.
  3. Request API access if you haven’t already (approval may be required).
  4. Once approved, generate your API Access Token from the API settings page.
  5. Enter your API Access Token into Alloy Automation.

API Documentation

For detailed API documentation, visit: https://www.faire.com/external-api-docs

Important Notes

  • Faire API access requires approval from Faire’s team
  • API keys are available for brands selling on Faire
  • The API provides access to order management, inventory updates, and product catalog
  • Keep your API token secure as it provides full access to your Faire account

Use Cases

1) Order synchronization

Automatically sync new orders from Faire retailers into your order management system or ERP, ensuring timely fulfillment and inventory updates.

2) Inventory management

Push real-time inventory levels from your warehouse management system to Faire, preventing overselling and keeping your product availability accurate for retailers.

3) Product catalog updates

Automatically update product information, pricing, and images on Faire when changes are made in your product information management (PIM) system.

4) Shipping and tracking

Sync shipment information and tracking numbers from your fulfillment system to Faire, keeping retailers informed about their order status.

5) Returns processing

Automatically process return requests and update inventory levels when retailers initiate returns through the Faire platform.

API Gotchas

  • API access approval: Faire requires approval for API access. Apply for API access through your account settings and wait for approval before integrating.
  • Rate limiting: Faire enforces rate limits on API requests. Monitor response headers and implement retry logic with exponential backoff when you receive rate limit errors.
  • Webhook reliability: Ensure your webhook endpoints are highly available and respond quickly with 2xx status codes. Failed webhooks may result in missed order notifications.
  • Inventory accuracy: Faire expects accurate inventory levels. Overselling can result in penalties, so ensure your inventory sync is reliable and real-time.
  • Product requirements: Products on Faire must meet specific quality and content standards. Ensure product data is complete and compliant before publishing.
For questions or troubleshooting, contact support@runalloy.com.
I