FUFU API
Connect your business to the FUFU n' Sauce platform. Manage products, sync inventory, process orders, and receive real-time webhooks.
REST API
Standard HTTP
JSON
Request & Response
24h JWT
Token Validity
4 Plans
Free to Enterprise
Authentication
Two Ways to Authenticate
Direct API Key
Pass your API key directly via the x-api-key header. Simplest for server-to-server calls.
curl -H "x-api-key: ffs_live_your_key_here" \
https://app.fufunsauce.com/api/v1/productsJWT Bearer Token
Exchange your API key for a 24-hour JWT token. Better for multi-request sessions.
# Step 1: Get token
curl -X POST https://app.fufunsauce.com/api/v1/auth \
-H "Content-Type: application/json" \
-d '{"api_key": "ffs_live_your_key_here"}'
# Step 2: Use token
curl -H "Authorization: Bearer ffs_tok_..." \
https://app.fufunsauce.com/api/v1/productsKey Format: ffs_live_[32 hex chars] for production, ffs_test_[32 hex chars] for sandbox. Keep your key secret — never expose it in client-side code.
Authentication Response
{
"token": "ffs_tok_...",
"expires_at": "2026-04-19T10:30:00.000Z",
"plan": "starter",
"rate_limit": 10000,
"vendor_id": "vendor_001"
}API Reference
Endpoints
Products
/api/v1/productsList all products for your vendor account. Supports pagination via ?page=&limit= query params.
curl -H "x-api-key: ffs_live_your_key_here" \
"https://app.fufunsauce.com/api/v1/products?page=1&limit=50"
# Response
{
"products": [
{
"id": "prod_001",
"name": "Suya Spice Blend",
"price": 12.99,
"sku": "SUYA-001",
"quantity": 240,
"is_active": true
}
],
"pagination": { "page": 1, "limit": 50, "total": 1, "has_more": false }
}/api/v1/productsCreate a new product listing. Include an id field to update an existing product. Requires Starter plan or higher.
curl -X POST \
-H "x-api-key: ffs_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"name": "Palm Oil (1L)",
"price": 14.99,
"sku": "PALM-1L",
"category": "oils",
"quantity": 120,
"description": "Cold-pressed red palm oil."
}' \
https://app.fufunsauce.com/api/v1/products/api/v1/products/:idRemove a product listing. Only the owning vendor can delete their products.
curl -X DELETE \
-H "x-api-key: ffs_live_your_key_here" \
https://app.fufunsauce.com/api/v1/products/prod_001Orders
/api/v1/ordersList orders placed by your account. Filter by status: pending, confirmed, processing, shipped, delivered, cancelled.
curl -H "x-api-key: ffs_live_your_key_here" \
"https://app.fufunsauce.com/api/v1/orders?status=shipped"
# Response
{
"orders": [
{
"id": "ord_001",
"status": "shipped",
"total": 185.00,
"items": [{ "sku": "EGUSI-2LB", "quantity": 10, "unit_price": 18.50 }]
}
]
}/api/v1/ordersCreate an order to purchase from another vendor on the platform. Requires Starter plan or higher.
curl -X POST \
-H "x-api-key: ffs_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"seller_id": "vendor_002",
"items": [
{ "product_id": "prod_002", "sku": "EGUSI-2LB", "quantity": 5, "unit_price": 18.50 }
],
"shipping_address": "123 Page Ave, St. Louis, MO 63104"
}' \
https://app.fufunsauce.com/api/v1/orders/api/v1/orders/:idUpdate the status of an order. Valid statuses: pending, confirmed, processing, shipped, delivered, cancelled.
curl -X PATCH \
-H "x-api-key: ffs_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{"status": "shipped"}' \
https://app.fufunsauce.com/api/v1/orders/ord_001Inventory
/api/v1/inventoryGet current inventory levels for all your SKUs.
curl -H "x-api-key: ffs_live_your_key_here" \
https://app.fufunsauce.com/api/v1/inventory
# Response
{
"inventory": [
{ "sku": "SUYA-001", "quantity": 240, "updated_at": "2026-04-10T00:00:00Z" }
],
"vendor_id": "vendor_001"
}/api/v1/inventory/syncBulk sync inventory levels for up to 500 SKUs in a single request. Requires Starter plan or higher.
curl -X POST \
-H "x-api-key: ffs_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"items": [
{ "sku": "SUYA-001", "quantity": 300 },
{ "sku": "PALM-1L", "quantity": 85 },
{ "sku": "EGUSI-2LB", "quantity": 60 }
]
}' \
https://app.fufunsauce.com/api/v1/inventory/syncWebhooks
/api/v1/webhooksRegister a webhook URL to receive real-time event notifications. Requires Starter plan. Supported events: order.created, order.shipped, order.delivered, order.cancelled, inventory.low
curl -X POST \
-H "x-api-key: ffs_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-server.com/fufu-webhook",
"events": ["order.created", "order.shipped", "inventory.low"]
}' \
https://app.fufunsauce.com/api/v1/webhooks/api/v1/webhooksList all registered webhooks for your vendor account.
curl -H "x-api-key: ffs_live_your_key_here" \
https://app.fufunsauce.com/api/v1/webhooks/api/v1/webhooks/:idRemove a webhook registration.
curl -X DELETE \
-H "x-api-key: ffs_live_your_key_here" \
https://app.fufunsauce.com/api/v1/webhooks/wh_1234567890Pricing
Rate Limits & Plans
| Plan | Requests/Day | Price | Features |
|---|---|---|---|
| Free | 100 | $0 | Read-only access |
| Starter | 10,000 | $49/mo | Full CRUD, basic webhooks |
| ProPOPULAR | 100,000 | $149/mo | Everything + priority support |
| Enterprise | Unlimited | $299/mo | Everything + dedicated endpoint |
X-RateLimit-Remaining and X-RateLimit-Reset. When exceeded, the API returns 429 Too Many Requests.Use Cases
What You Can Build
Sync your POS inventory automatically
Push real-time inventory updates from your point-of-sale system to the FUFU platform in bulk.
Build a custom ordering interface
Create a branded order flow for your customers using your own frontend backed by FUFU products.
Automate wholesale purchasing
Set up automated reorder triggers when stock dips below threshold, no manual work required.
Connect your accounting software
Pull order and invoice data into QuickBooks, Xero, or your ERP via webhooks and the Orders API.
Get Started
Request API Access
Fill out the form and we'll have your API key ready within 1 business day. Start on the free plan immediately, or select a paid plan for higher limits.