Skip to main content
API v1 — Now Available

FUFU API

Connect your business to the FUFU n' Sauce platform. Manage products, sync inventory, process orders, and receive real-time webhooks.

Get Your API KeyView Endpoints

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/products

JWT 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/products

Key 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

GET/api/v1/products

List 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 }
}
POST/api/v1/products

Create 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
DELETE/api/v1/products/:id

Remove 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_001

Orders

GET/api/v1/orders

List 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 }]
    }
  ]
}
POST/api/v1/orders

Create 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
PATCH/api/v1/orders/:id

Update 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_001

Inventory

GET/api/v1/inventory

Get 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"
}
POST/api/v1/inventory/sync

Bulk 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/sync

Webhooks

POST/api/v1/webhooks

Register 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
GET/api/v1/webhooks

List all registered webhooks for your vendor account.

curl -H "x-api-key: ffs_live_your_key_here" \
  https://app.fufunsauce.com/api/v1/webhooks
DELETE/api/v1/webhooks/:id

Remove a webhook registration.

curl -X DELETE \
  -H "x-api-key: ffs_live_your_key_here" \
  https://app.fufunsauce.com/api/v1/webhooks/wh_1234567890

Pricing

Rate Limits & Plans

PlanRequests/DayPriceFeatures
Free100$0Read-only access
Starter10,000$49/moFull CRUD, basic webhooks
ProPOPULAR100,000$149/moEverything + priority support
EnterpriseUnlimited$299/moEverything + dedicated endpoint
Rate limit headers are included in every response: 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.

1
Submit request form
2
Receive API key via email
3
Authenticate & start building

API Access Request