ReviewFlow API introduction

Overview

ReviewFlow is the Tailoredd reviews and Q&A platform. The API is REST-based with JSON responses.

REST + JSON

Standard HTTP verbs. Every response returns { "success": true, "data": ... } or a structured error.

Header auth

All requests require X-Merchant-Id. Server calls add X-API-Key; admin calls add Authorization.

Plan-gated features

Some endpoints return 403 PLAN_UPGRADE_REQUIRED on Standard plan. See Plans.

Get access

You receive your Base URL, Merchant ID, and API Key after onboarding. Email contact@tailoredd.com.

Your credentials

After you sign the contract, Tailoredd provisions the following:

Credential	Description
Base URL	Production uses `https://cdn.tailoredd.com/apiV2`; staging uses the direct `apiV2` endpoint. Set as `RF_BASE_URL` in your environment.
Merchant ID	Sent as `X-Merchant-Id` on every request.
API Key	Server-side secret. Prefix `tr_`. Set as `RF_API_KEY`. Never expose client-side.
Webhook Secret	Used to sign `X-Webhook-Signature` on order-complete calls.
Allowed Origins	Whitelisted domains for browser/widget requests.

Contact contact@tailoredd.com for Merchant ID, API Key, webhook secret, and allowed-origin setup.

Quick start

curl -X GET \
  "${RF_BASE_URL}/products/${PRODUCT_ID}/reviews?limit=10&sort=newest" \
  -H "X-Merchant-Id: YOUR_MERCHANT_ID" \
  -H "X-API-Key: YOUR_API_KEY"

​Overview

REST + JSON

Header auth

Plan-gated features

Get access

​Your credentials

​Quick start

Overview

Your credentials

Quick start